@boxes-dev/dvb-runtime 1.0.957 → 1.0.959

package/dist/bin/dvb.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!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]="a55a831a-e9eb-5e0c-9e31-0c4bceb58a84")}catch(e){}}();
+!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]="622a15c0-7c29-5be9-a35c-b1a193a6b0f0")}catch(e){}}();
 import { createRequire as __dvbCreateRequire } from "node:module";
 import { dirname as __dvbDirname } from "node:path";
 import { fileURLToPath as __dvbFileURLToPath } from "node:url";
@@ -101145,8 +101145,8 @@ var init_otel = __esm({
       return trimmed && trimmed.length > 0 ? trimmed : void 0;
     };
     readBuildMetadata = () => {
-      const rawPackageVersion = "1.0.957";
-      const rawGitSha = "bd2eee580a498b70adca3fcd0e8c9d25eb248aaf";
+      const rawPackageVersion = "1.0.959";
+      const rawGitSha = "c5992d38486ffdbc188773dfe7556175ffb24abc";
       const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
       const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
       return { packageVersion, gitSha };
@@ -133552,9 +133552,9 @@ var init_sentry = __esm({
     uncaughtExceptionMonitorInstalled = false;
     currentDevboxSentryUser = null;
     readBuildMetadata2 = () => {
-      const rawPackageVersion = "1.0.957";
-      const rawGitSha = "bd2eee580a498b70adca3fcd0e8c9d25eb248aaf";
-      const rawSentryRelease = "boxes-dev-dvb@1.0.957+bd2eee580a498b70adca3fcd0e8c9d25eb248aaf";
+      const rawPackageVersion = "1.0.959";
+      const rawGitSha = "c5992d38486ffdbc188773dfe7556175ffb24abc";
+      const rawSentryRelease = "boxes-dev-dvb@1.0.959+c5992d38486ffdbc188773dfe7556175ffb24abc";
       const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
       const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
       const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -138235,8 +138235,8 @@ var init_desktopSetupReview = __esm({
       const summary = uniqueNonEmpty(sourceParts).join(" \xB7 ");
       return summary || databaseSourceKindLabel(entry.source.kind);
     };
-    createItem = ({ detailLines = [], included = true, section, source, sourceIndex, subtitle = null, title, warning: warning3 = null }) => ({
-      id: itemId({ section, source, sourceIndex }),
+    createItem = ({ detailLines = [], id: id2 = null, included = true, section, source, sourceIndex, subtitle = null, title, warning: warning3 = null }) => ({
+      id: id2 ?? itemId({ section, source, sourceIndex }),
       section,
       source,
       sourceIndex,
@@ -138300,6 +138300,8 @@ var init_desktopSetupReview = __esm({
           }));
         case "databases":
           return plan.databaseCopies.map((entry, index) => createItem({
+            id: `databases:database_copy:${encodeURIComponent(entry.id)}`,
+            included: entry.canAutomate,
             section,
             source: "database_copy",
             sourceIndex: index,
@@ -138717,7 +138719,7 @@ var init_packageVersion = __esm({
       return path17.join(process.cwd(), "dvb");
     };
     readEmbeddedPackageVersion = () => {
-      const raw = "1.0.957";
+      const raw = "1.0.959";
       return trimVersion(raw);
     };
     readNearestPackageMetadata = (basePath) => {
@@ -300601,7 +300603,7 @@ var init_scanOutputs = __esm({
         return false;
       }
       const resolved = source.resolvedNonSecret;
-      return typeof value.id === "string" && typeof value.engine === "string" && typeof value.displayLabel === "string" && typeof value.canAutomate === "boolean" && typeof value.confidence === "string" && Array.isArray(value.evidence) && typeof source.kind === "string" && Array.isArray(source.refs) && source.refs.every(isDatabaseSourceRef) && isObject8(resolved) && (resolved.host === null || typeof resolved.host === "string") && (resolved.port === null || typeof resolved.port === "number") && (resolved.database === null || typeof resolved.database === "string") && (resolved.username === null || typeof resolved.username === "string") && (resolved.schema === null || typeof resolved.schema === "string") && (resolved.sslMode === null || typeof resolved.sslMode === "string") && typeof source.locality === "string" && typeof target.mode === "string" && (target.ref === null || typeof target.ref === "string") && typeof restoreHint.commandFamily === "string" && typeof restoreHint.expectedFormat === "string" && (value.skipReason === null || typeof value.skipReason === "string");
+      return typeof value.id === "string" && value.id.trim().length > 0 && typeof value.engine === "string" && typeof value.displayLabel === "string" && typeof value.canAutomate === "boolean" && typeof value.confidence === "string" && Array.isArray(value.evidence) && typeof source.kind === "string" && Array.isArray(source.refs) && source.refs.every(isDatabaseSourceRef) && isObject8(resolved) && (resolved.host === null || typeof resolved.host === "string") && (resolved.port === null || typeof resolved.port === "number") && (resolved.database === null || typeof resolved.database === "string") && (resolved.username === null || typeof resolved.username === "string") && (resolved.schema === null || typeof resolved.schema === "string") && (resolved.sslMode === null || typeof resolved.sslMode === "string") && typeof source.locality === "string" && typeof target.mode === "string" && (target.ref === null || typeof target.ref === "string") && typeof restoreHint.commandFamily === "string" && typeof restoreHint.expectedFormat === "string" && (value.skipReason === null || typeof value.skipReason === "string");
     };
     isManagedConfigPath = (value, rootName) => {
       const normalized = value.replaceAll("\\", "/").replace(/\/+$/u, "").trim();
@@ -300652,6 +300654,11 @@ var init_scanOutputs = __esm({
           if (!databaseCandidates.every(isDatabaseCopyCandidate)) {
             throw new Error("Invalid database candidate scan output.");
           }
+          if (new Set(databaseCandidates.map((candidate) => candidate.id)).size !== databaseCandidates.length) {
+            throw new Error(
+              "Invalid database candidate scan output: ids must be unique."
+            );
+          }
           return {
             schemaVersion: parsed.schemaVersion,
             scanFullyCompleted: parsed.scanFullyCompleted,
@@ -303572,7 +303579,7 @@ import os25 from "node:os";
 import path51 from "node:path";
 import process25 from "node:process";
 import { pipeline } from "node:stream/promises";
-var SNAPSHOT_VERSION, X25519_SPKI_DER_PREFIX, DATABASE_DUMP_TIMEOUT_MS, REPO_SSH_VERIFY_TIMEOUT_MS, DATABASE_DUMP_TOOL_MISSING_ERROR_CODE, DATABASE_DUMP_CLIENT_VERSION_MISMATCH_ERROR_CODE, DATABASE_DUMP_FAILED_ERROR_CODE, MULTIPART_UPLOAD_URL_REFRESH_SKEW_MS, nowIso7, trim10, toErrorMessage, toRedactedError, normalizeAgentConfigSelection2, createAgentConfigSnapshot, normalizeAgentThreadHistorySelection, normalizeAgentThreadImportWarning, normalizeAgentThreadImportScope, createAgentThreadHistorySnapshot, assertGitSigningReadyForBundle, shellQuote5, ensureDir7, pathExists4, readJsonFile2, writeJsonFile4, writeRepoMarker, runCommand7, runCommandToFile, formatMissingDatabaseDumpToolMessage, createMissingDatabaseDumpToolError, createPostgresDumpVersionMismatchError, createDatabaseDumpExecutionError, executeDatabaseDumpCommand, runDatabaseDumpCommand, spawnCommand, isRepoInitArtifactPath2, readDirtyWorktreeState, readProjectDirtyWorktreeState, hasGitHead, readGitHeadInfo, copyPathIntoRoot, isPathInside, copyLocalPath2, createUserFacingEnvFileError, deriveEnvStagingId, snapshotEnvStagingFile, deleteEnvStagingFile, pruneEnvStagingFilesExcept, copyStagedEditableSetupFile, createRepoPayloadOwnership, createProjectPayloadOwnership, relativeFromStagingRoot2, resolveRepoPayloadRoot, addCopiedInventoryLeaf2, copyPathWithInventory2, copyPathWithRepoPayloadExclusions, directorySize3, createInitialScanState, createApprovals, createUploadState, setUploadProgressState, createBundleOptions, createLfsWithoutRepoSshWarning, buildLocalPrepWarnings, createForkStartupScriptSetup, createDestroyedLocalPrepSnapshot, mergeSetupPlanForRescan, SETUP_REVIEW_SECTION_SCAN_CATEGORY, reviewStatusForScanStatus, buildReviewSectionStatusesFromScanState, buildReviewState, normalizeSetupReviewRescanRequest, getSetupReviewSectionsForScanCategories, normalizeSetupReviewRetryFailedScansRequest, assertRetryableInterruptedScanCategories, DESKTOP_INIT_SCAN_FOCUS_SET, createDesktopInitRequestValidationError, isDesktopInitRequestValidationError, normalizeDesktopInitScanFocus, normalizeLocalPrepScanCategories, hasStartedOrSkippedInitialScan, resolveLockedScanFocus, isInitialScanCategoryResolved, areInitialScanCategoriesResolved, getRunnableInitialScanCategories, getSkippableInitialScanCategories, applyRescanStateToReview, markScanCategories, normalizeDirtyWorktreeForSnapshot, normalizeScanStateForSnapshot, createSnapshotFromState, createLocalPrepState, buildSkippedRepoSshSetup, getRepoSshBundleDecisionKey, parseGitRemoteHost2, acquireLocalLock, releaseLocalLock, captureShellEnvironment, safeName2, resolveSetupArtifactSource, findOwningProjectLayoutRepo, gitCommandSucceeds, isIgnoredUntrackedRepoFile, resolveEnvFileArtifactSource, isEligibleAgentEnvFileSource, buildReviewEnvFileEntry, enrichSetupPlanEnvFiles, DESKTOP_SHELL_RC_IMPORTS, resolveShellRcSourcePath, deriveShellRcStagingId, resolvesToShellRcSource, enrichSetupPlanShellRcFiles, wrapSetupArtifactCopyError, copySetupArtifacts, collectRepoScopedSetupArtifactPaths, copyGitMetadata, copyGlobalGitConfig, ensureDevboxAccessPublicKey, writeDirtyPayloads, GIT_CHECK_ATTR_PATH_CHUNK_SIZE, forEachTrackedLfsManagedPath, createLfsWorktreePayloads, createRepoPayloads, createProjectRootPayloads, createAggregateRepoPayloadState, addRepoPayloadState, buildSkippedRepoSshSetupForLayoutRepo, shouldConvertHttpsRepoOriginToSsh, buildRepoSshSetupForLayoutRepo, getPreOwnedRepoPathsForLayoutRepo, createProjectRepoPayloads, stripEnvValueQuotes, readRawEnvFileValues, resolveLocalReferencePath, parseEnvFileRef, readDatabaseEnvFileValue, getDatabaseValueForRole, isSupportedDatabaseUrlProtocol, parseDatabaseUrlForDump, appendEnvValue, normalizeDatabasePort, resolveDatabaseConnectionFields, resolveDatabaseDumpCommand, safeDatabaseDumpBaseName, formatDatabaseDumpFailureMessage, createDatabaseDumpFailureError, preflightDatabaseDumpCandidates, createDatabasePayloads, stripLocalEnvFileReviewMetadata, stripLocalExternalConfigReviewMetadata, buildRemoteSetupPlan, createInnerBundleStaging, stageRepoSshSetup, createTarGz, sha256File2, encryptBundle, buildX25519PublicKey, createKeyEnvelope, createPrivatePublicX25519Pair, MULTIPART_UPLOAD_RECOVERY_ROUND_COUNT, MULTIPART_UPLOAD_RECOVERY_BASE_DELAY_MS, REMOTE_DESTROY_POLL_INTERVAL_MS, REMOTE_DESTROY_TIMEOUT_MS, sleep5, sanitizeMultipartUploadPartsForState, createMultipartUploadState, shouldRefreshMultipartUploadUrlsBeforeUpload, normalizeRepo, normalizeOptionalProjectInstanceTypeKey, normalizeSelectedProjectRepoRelPaths, buildDesktopProjectLayoutRepo, readGitConfigValues, unsetGitConfigIfExactlyMatches, removeEmptyDirectoryIfPresent, shouldCleanupProjectLayoutClaims, cleanupProjectLayoutClaims, resolveSelectedProjectRepoRelPaths, claimDesktopProjectLayout, buildLocalScanProjectLayoutContext, normalizeSelectedAgents, normalizeBackendJobReference, getRemoteDestroyFailureMessage, waitForRemoteDestroyCompletion, normalizeApprovedEnvFile, normalizeApprovedPlan, shouldPreserveVerifiedRepoSshSetup, normalizeManagedGithubAccessRepository, normalizeManagedGithubAccess, buildManagedGithubAccessForProjectLayout, createDesktopLocalPrepService;
+var SNAPSHOT_VERSION, X25519_SPKI_DER_PREFIX, DATABASE_DUMP_TIMEOUT_MS, DATABASE_APPROVAL_PREFLIGHT_TIMEOUT_MS, DATABASE_APPROVAL_PREFLIGHT_CONCURRENCY, REPO_SSH_VERIFY_TIMEOUT_MS, DATABASE_DUMP_TOOL_MISSING_ERROR_CODE, DATABASE_DUMP_CLIENT_VERSION_MISMATCH_ERROR_CODE, DATABASE_DUMP_FAILED_ERROR_CODE, MULTIPART_UPLOAD_URL_REFRESH_SKEW_MS, nowIso7, trim10, toErrorMessage, toRedactedError, normalizeAgentConfigSelection2, createAgentConfigSnapshot, normalizeAgentThreadHistorySelection, normalizeAgentThreadImportWarning, normalizeAgentThreadImportScope, createAgentThreadHistorySnapshot, assertGitSigningReadyForBundle, shellQuote5, ensureDir7, pathExists4, readJsonFile2, writeJsonFile4, writeRepoMarker, runCommand7, runCommandToFile, formatMissingDatabaseDumpToolMessage, createMissingDatabaseDumpToolError, createPostgresDumpVersionMismatchError, DATABASE_DUMP_FAILURE_USER_MESSAGES, createDatabaseDumpExecutionError, classifyDatabaseDumpFailure, executeDatabaseDumpCommand, runDatabaseDumpCommand, spawnCommand, isRepoInitArtifactPath2, readDirtyWorktreeState, readProjectDirtyWorktreeState, hasGitHead, readGitHeadInfo, copyPathIntoRoot, isPathInside, copyLocalPath2, createUserFacingEnvFileError, deriveEnvStagingId, snapshotEnvStagingFile, deleteEnvStagingFile, pruneEnvStagingFilesExcept, copyStagedEditableSetupFile, createRepoPayloadOwnership, createProjectPayloadOwnership, relativeFromStagingRoot2, resolveRepoPayloadRoot, addCopiedInventoryLeaf2, copyPathWithInventory2, copyPathWithRepoPayloadExclusions, directorySize3, createInitialScanState, createApprovals, createUploadState, setUploadProgressState, createBundleOptions, createLfsWithoutRepoSshWarning, buildLocalPrepWarnings, createForkStartupScriptSetup, createDestroyedLocalPrepSnapshot, mergeSetupPlanForRescan, SETUP_REVIEW_SECTION_SCAN_CATEGORY, reviewStatusForScanStatus, buildReviewSectionStatusesFromScanState, buildReviewState, normalizeSetupReviewRescanRequest, getSetupReviewSectionsForScanCategories, normalizeSetupReviewRetryFailedScansRequest, assertRetryableInterruptedScanCategories, DESKTOP_INIT_SCAN_FOCUS_SET, createDesktopInitRequestValidationError, isDesktopInitRequestValidationError, normalizeDesktopInitScanFocus, normalizeLocalPrepScanCategories, hasStartedOrSkippedInitialScan, resolveLockedScanFocus, isInitialScanCategoryResolved, areInitialScanCategoriesResolved, getRunnableInitialScanCategories, getSkippableInitialScanCategories, applyRescanStateToReview, markScanCategories, normalizeDirtyWorktreeForSnapshot, normalizeScanStateForSnapshot, createSnapshotFromState, createLocalPrepState, buildSkippedRepoSshSetup, getRepoSshBundleDecisionKey, parseGitRemoteHost2, acquireLocalLock, releaseLocalLock, captureShellEnvironment, safeName2, resolveSetupArtifactSource, findOwningProjectLayoutRepo, gitCommandSucceeds, isIgnoredUntrackedRepoFile, resolveEnvFileArtifactSource, isEligibleAgentEnvFileSource, buildReviewEnvFileEntry, enrichSetupPlanEnvFiles, DESKTOP_SHELL_RC_IMPORTS, resolveShellRcSourcePath, deriveShellRcStagingId, resolvesToShellRcSource, enrichSetupPlanShellRcFiles, wrapSetupArtifactCopyError, copySetupArtifacts, collectRepoScopedSetupArtifactPaths, copyGitMetadata, copyGlobalGitConfig, ensureDevboxAccessPublicKey, writeDirtyPayloads, GIT_CHECK_ATTR_PATH_CHUNK_SIZE, forEachTrackedLfsManagedPath, createLfsWorktreePayloads, createRepoPayloads, createProjectRootPayloads, createAggregateRepoPayloadState, addRepoPayloadState, buildSkippedRepoSshSetupForLayoutRepo, shouldConvertHttpsRepoOriginToSsh, buildRepoSshSetupForLayoutRepo, getPreOwnedRepoPathsForLayoutRepo, createProjectRepoPayloads, stripEnvValueQuotes, readRawEnvFileValues, resolveLocalReferencePath, parseEnvFileRef, readDatabaseEnvFileValue, createDatabaseSourceValidationError, getDatabaseValueForRole, isSupportedDatabaseUrlProtocol, parseDatabaseUrlForDump, appendEnvValue, normalizeDatabasePort, resolveDatabaseConnectionFields, resolveDatabaseDumpCommand, safeDatabaseDumpBaseName, formatDatabaseDumpFailureMessage, createPublicDatabaseDumpFailure, createDatabaseDumpFailureError, buildDatabasePreflightArgs, preflightDatabaseDumpCandidates, createDatabasePayloads, stripLocalEnvFileReviewMetadata, stripLocalExternalConfigReviewMetadata, buildRemoteSetupPlan, createInnerBundleStaging, stageRepoSshSetup, createTarGz, sha256File2, encryptBundle, buildX25519PublicKey, createKeyEnvelope, createPrivatePublicX25519Pair, MULTIPART_UPLOAD_RECOVERY_ROUND_COUNT, MULTIPART_UPLOAD_RECOVERY_BASE_DELAY_MS, REMOTE_DESTROY_POLL_INTERVAL_MS, REMOTE_DESTROY_TIMEOUT_MS, sleep5, sanitizeMultipartUploadPartsForState, createMultipartUploadState, shouldRefreshMultipartUploadUrlsBeforeUpload, normalizeRepo, normalizeOptionalProjectInstanceTypeKey, normalizeSelectedProjectRepoRelPaths, buildDesktopProjectLayoutRepo, readGitConfigValues, unsetGitConfigIfExactlyMatches, removeEmptyDirectoryIfPresent, shouldCleanupProjectLayoutClaims, cleanupProjectLayoutClaims, resolveSelectedProjectRepoRelPaths, claimDesktopProjectLayout, buildLocalScanProjectLayoutContext, normalizeSelectedAgents, normalizeBackendJobReference, getRemoteDestroyFailureMessage, waitForRemoteDestroyCompletion, normalizeApprovedEnvFile, normalizeApprovedPlan, shouldPreserveVerifiedRepoSshSetup, normalizeManagedGithubAccessRepository, normalizeManagedGithubAccess, buildManagedGithubAccessForProjectLayout, createDesktopLocalPrepService;
 var init_localPrepService = __esm({
   "../../../../shared/initPrep/src/localPrepService.mjs"() {
     "use strict";
@@ -303592,6 +303599,8 @@ var init_localPrepService = __esm({
     SNAPSHOT_VERSION = DESKTOP_INIT_CONTRACT_VERSION;
     X25519_SPKI_DER_PREFIX = Buffer.from("302a300506032b656e032100", "hex");
     DATABASE_DUMP_TIMEOUT_MS = 10 * 60 * 1e3;
+    DATABASE_APPROVAL_PREFLIGHT_TIMEOUT_MS = 5 * 1e3;
+    DATABASE_APPROVAL_PREFLIGHT_CONCURRENCY = 3;
     REPO_SSH_VERIFY_TIMEOUT_MS = 30 * 1e3;
     DATABASE_DUMP_TOOL_MISSING_ERROR_CODE = "desktop_database_dump_tool_missing";
     DATABASE_DUMP_CLIENT_VERSION_MISMATCH_ERROR_CODE = "desktop_database_dump_client_version_mismatch";
@@ -303606,7 +303615,8 @@ var init_localPrepService = __esm({
       reason: error55 instanceof Error && typeof error55.desktopInitErrorReason === "string" ? error55.desktopInitErrorReason : void 0,
       requestId: null,
       retryable: error55 instanceof Error && typeof error55.retryable === "boolean" ? error55.retryable : true,
-      userMessage: error55 instanceof Error && typeof error55.userMessage === "string" ? error55.userMessage : void 0
+      userMessage: error55 instanceof Error && typeof error55.userMessage === "string" ? error55.userMessage : void 0,
+      ...error55 instanceof Error && Array.isArray(error55.desktopDatabaseDumpFailures) ? { databaseDumpFailures: error55.desktopDatabaseDumpFailures } : {}
     });
     normalizeAgentConfigSelection2 = ({ agentConfig, selection }) => {
       const validItemIds = new Set(
@@ -303879,7 +303889,7 @@ var init_localPrepService = __esm({
       if (command === "pg_dump") {
         return [
           "boxes.dev could not find a usable pg_dump tool, so database copy was skipped.",
-          "Update or reinstall boxes.dev to restore its included PostgreSQL tools, or install PostgreSQL client tools and make sure pg_dump is on PATH, then retry bundle preparation.",
+          "Update or reinstall boxes.dev to restore its included PostgreSQL tools, or install PostgreSQL client tools and make sure pg_dump is on PATH, then retry the database copy.",
           "On macOS: run `brew install libpq` and add `$(brew --prefix libpq)/bin` to PATH, or install Postgres.app and add `/Applications/Postgres.app/Contents/Versions/latest/bin` to PATH.",
           "Verify with `pg_dump --version`."
         ].join(" ");
@@ -303887,7 +303897,7 @@ var init_localPrepService = __esm({
       if (command === "mysqldump") {
         return [
           "mysqldump is not installed locally, so database copy was skipped.",
-          "Install MySQL or MariaDB client tools from the same database family and major or LTS release as the local server, make sure mysqldump is on PATH, then retry bundle preparation.",
+          "Install MySQL or MariaDB client tools from the same database family and major or LTS release as the local server, make sure mysqldump is on PATH, then retry the database copy.",
           "Verify with `mysqldump --version`."
         ].join(" ");
       }
@@ -303897,7 +303907,7 @@ var init_localPrepService = __esm({
       const error55 = new Error(formatMissingDatabaseDumpToolMessage(command));
       error55.desktopInitErrorCode = DATABASE_DUMP_TOOL_MISSING_ERROR_CODE;
       error55.desktopInitErrorReason = command;
-      error55.userMessage = command === "pg_dump" ? "Update or reinstall boxes.dev to restore its included PostgreSQL tools, or install pg_dump and make sure it is available on PATH, then retry bundle preparation." : command === "mysqldump" ? "Install mysqldump from the same database family and major or LTS release as the local server, verify it with `mysqldump --version`, then retry. To proceed without local database data, change this database copy to skip." : `Install ${command}, make sure it is available on PATH, then retry bundle preparation.`;
+      error55.userMessage = command === "pg_dump" ? "Update or reinstall boxes.dev to restore its included PostgreSQL tools, or install pg_dump and make sure it is available on PATH, then retry the database copy." : command === "mysqldump" ? "Install mysqldump from the same database family and major or LTS release as the local server, verify it with `mysqldump --version`, then retry the database copy. To proceed without local database data, skip this database." : `Install ${command}, make sure it is available on PATH, then retry the database copy.`;
       return error55;
     };
     createPostgresDumpVersionMismatchError = (stderr, { source = "system" } = {}) => {
@@ -303914,10 +303924,20 @@ var init_localPrepService = __esm({
       );
       error55.desktopInitErrorCode = DATABASE_DUMP_CLIENT_VERSION_MISMATCH_ERROR_CODE;
       error55.desktopInitErrorReason = "pg_dump";
-      error55.userMessage = source === "managed" ? "This PostgreSQL server is newer than the pg_dump included with this version of boxes.dev. Update boxes.dev or install a compatible client, then re-run `dvb agent-init check`." : "Install a pg_dump client at least as new as the PostgreSQL server, verify it with `pg_dump --version`, then re-run `dvb agent-init check`.";
+      error55.userMessage = source === "managed" ? "This PostgreSQL server is newer than the pg_dump included with this version of boxes.dev. Update boxes.dev or install a compatible client, then retry the database copy." : "Install a pg_dump client at least as new as the PostgreSQL server, verify it with `pg_dump --version`, then retry the database copy.";
       return error55;
     };
-    createDatabaseDumpExecutionError = (toolName, { timedOut = false } = {}) => {
+    DATABASE_DUMP_FAILURE_USER_MESSAGES = {
+      authentication_failed: "The database rejected the selected credentials. Check the project\u2019s database settings, then retry.",
+      connection_refused: "Nothing accepted the connection at the selected host and port. Start the database or update the connection, then retry.",
+      database_missing: "The selected database does not exist. Update the database name, then retry.",
+      host_unresolved: "This computer cannot resolve the selected database host. Use a host-reachable endpoint, then retry.",
+      password_missing: "The connection needs a password, but the selected credential reference did not provide one. Update the database settings, then retry.",
+      permission_denied: "The selected database user cannot read the database catalog. Grant dump access or use a different database user, then retry.",
+      source_url_missing: "The selected database URL wasn\u2019t available from the project environment or an env file. Update the connection or skip this database.",
+      timeout: "The database did not respond in time. Start it or make the selected endpoint reachable, then retry."
+    };
+    createDatabaseDumpExecutionError = (toolName, { failureKind = "unknown", timedOut = false } = {}) => {
       const summary = timedOut ? `${toolName} timed out while creating a database dump.` : `${toolName} failed while creating a database dump.`;
       const error55 = new Error(
         toolName === "mysqldump" ? [
@@ -303928,9 +303948,65 @@ var init_localPrepService = __esm({
       );
       error55.desktopInitErrorCode = DATABASE_DUMP_FAILED_ERROR_CODE;
       error55.desktopInitErrorReason = toolName;
-      error55.userMessage = toolName === "mysqldump" ? "Confirm the local MySQL or MariaDB server and credentials work. If needed, install mysqldump from the same database family and major or LTS release as the server, verify it with `mysqldump --version`, then re-run `dvb agent-init check`. To proceed without local database data, change this database copy to skip." : `Fix the ${toolName} failure, then retry. To proceed without local database data, change this database copy to skip.`;
+      const effectiveFailureKind = timedOut ? "timeout" : failureKind;
+      error55.desktopDatabaseFailureKind = effectiveFailureKind;
+      error55.userMessage = DATABASE_DUMP_FAILURE_USER_MESSAGES[effectiveFailureKind] ?? (toolName === "mysqldump" ? "Confirm the local MySQL or MariaDB server and credentials work. If needed, install mysqldump from the same database family and major or LTS release as the server, verify it with `mysqldump --version`, then retry the database copy or skip this database." : `Fix the ${toolName} failure, then retry the database copy or skip this database.`);
       return error55;
     };
+    classifyDatabaseDumpFailure = ({ stderr, toolName }) => {
+      const normalized = trim10(stderr);
+      if (!normalized) {
+        return "unknown";
+      }
+      if (toolName === "pg_dump") {
+        if (/could not translate host name/iu.test(normalized)) {
+          return "host_unresolved";
+        }
+        if (/connection to server[\s\S]*failed:[\s\S]*Connection refused/iu.test(
+          normalized
+        )) {
+          return "connection_refused";
+        }
+        if (/password authentication failed for user/iu.test(normalized)) {
+          return "authentication_failed";
+        }
+        if (/(?:fe_sendauth: )?no password supplied/iu.test(normalized)) {
+          return "password_missing";
+        }
+        if (/database [\s\S]+ does not exist/iu.test(normalized)) {
+          return "database_missing";
+        }
+        if (/permission denied/iu.test(normalized)) {
+          return "permission_denied";
+        }
+        return "unknown";
+      }
+      if (toolName === "mysqldump") {
+        if (/Unknown MySQL server host|Name or service not known|nodename nor servname provided/iu.test(
+          normalized
+        )) {
+          return "host_unresolved";
+        }
+        if (/Can(?:not|'t) connect to (?:local )?MySQL server|Connection refused/iu.test(
+          normalized
+        )) {
+          return "connection_refused";
+        }
+        if (/Access denied for user[\s\S]*using password: NO/iu.test(normalized)) {
+          return "password_missing";
+        }
+        if (/Access denied for user/iu.test(normalized)) {
+          return "authentication_failed";
+        }
+        if (/Unknown database/iu.test(normalized)) {
+          return "database_missing";
+        }
+        if (/command denied to user|permission denied/iu.test(normalized)) {
+          return "permission_denied";
+        }
+      }
+      return "unknown";
+    };
     executeDatabaseDumpCommand = (command, args, {
       cwd: cwd2,
       env: env3,
@@ -303964,9 +304040,10 @@ var init_localPrepService = __esm({
             );
             return;
           }
+          const stderrText = Buffer.isBuffer(stderr) ? stderr.toString("utf8") : "";
           if (toolName === "pg_dump") {
             const versionMismatch = createPostgresDumpVersionMismatchError(
-              Buffer.isBuffer(stderr) ? stderr.toString("utf8") : "",
+              stderrText,
               { source }
             );
             if (versionMismatch) {
@@ -303974,7 +304051,14 @@ var init_localPrepService = __esm({
               return;
             }
           }
-          reject(createDatabaseDumpExecutionError(toolName));
+          reject(
+            createDatabaseDumpExecutionError(toolName, {
+              failureKind: classifyDatabaseDumpFailure({
+                stderr: stderrText,
+                toolName
+              })
+            })
+          );
         }
       );
     });
@@ -306523,6 +306607,16 @@ var init_localPrepService = __esm({
       }
       return null;
     };
+    createDatabaseSourceValidationError = ({
+      failureKind,
+      message,
+      userMessage
+    }) => {
+      const error55 = new Error(message);
+      error55.desktopDatabaseFailureKind = failureKind;
+      error55.userMessage = userMessage;
+      return error55;
+    };
     getDatabaseValueForRole = async ({
       databaseEnv,
       homeDir: homeDir2,
@@ -306630,7 +306724,11 @@ var init_localPrepService = __esm({
           role: "url"
         });
         if (!rawUrl) {
-          throw new Error("Missing database URL value.");
+          throw createDatabaseSourceValidationError({
+            failureKind: "source_url_missing",
+            message: "Missing database URL value.",
+            userMessage: DATABASE_DUMP_FAILURE_USER_MESSAGES.source_url_missing
+          });
         }
         return parseDatabaseUrlForDump({ expectedEngine, rawUrl });
       }
@@ -306707,7 +306805,7 @@ var init_localPrepService = __esm({
           homeDir: homeDir2,
           repoRoot
         });
-        const envForDump2 = { ...databaseEnv };
+        const envForDump2 = { ...databaseEnv, LC_ALL: "C" };
         appendEnvValue(envForDump2, "PGHOST", parsed2.host);
         appendEnvValue(envForDump2, "PGPORT", normalizeDatabasePort(parsed2.port));
         appendEnvValue(envForDump2, "PGDATABASE", parsed2.database);
@@ -306759,7 +306857,7 @@ var init_localPrepService = __esm({
         args.push(`--ssl-mode=${parsed.sslMode}`);
       }
       args.push(parsed.database);
-      const envForDump = { ...databaseEnv };
+      const envForDump = { ...databaseEnv, LC_ALL: "C" };
       appendEnvValue(envForDump, "MYSQL_PWD", parsed.password);
       return {
         command: "mysqldump",
@@ -306775,8 +306873,19 @@ var init_localPrepService = __esm({
       }).join("; ");
       return `Database dump creation failed for ${failures.length === 1 ? "an approved database" : "approved databases"}: ${details}`;
     };
+    createPublicDatabaseDumpFailure = ({ candidate, error: error55 }) => ({
+      candidateId: typeof candidate?.id === "string" && candidate.id.trim() ? candidate.id : null,
+      label: typeof candidate?.displayLabel === "string" && candidate.displayLabel.trim() ? candidate.displayLabel : candidate?.id ?? "database",
+      engine: candidate?.engine === "postgres" || candidate?.engine === "mysql" ? candidate.engine : null,
+      code: error55 instanceof Error && typeof error55.desktopInitErrorCode === "string" ? error55.desktopInitErrorCode : null,
+      failureKind: error55 instanceof Error && typeof error55.desktopDatabaseFailureKind === "string" ? error55.desktopDatabaseFailureKind : null,
+      userMessage: error55 instanceof Error && typeof error55.userMessage === "string" ? error55.userMessage : "Setup could not copy this database. Check that it is running and that the selected connection works, then retry."
+    });
     createDatabaseDumpFailureError = (failures) => {
       const error55 = new Error(formatDatabaseDumpFailureMessage(failures));
+      error55.desktopDatabaseDumpFailures = failures.map(
+        createPublicDatabaseDumpFailure
+      );
       if (failures.length === 1) {
         const failureError = failures[0].error;
         if (failureError instanceof Error && typeof failureError.desktopInitErrorCode === "string") {
@@ -306796,7 +306905,7 @@ var init_localPrepService = __esm({
         ];
         error55.desktopInitErrorCode = DATABASE_DUMP_TOOL_MISSING_ERROR_CODE;
         error55.desktopInitErrorReason = missingCommands.length === 1 ? missingCommands[0] : "multiple";
-        error55.userMessage = missingCommands.length === 1 ? createMissingDatabaseDumpToolError(missingCommands[0]).userMessage : "Install the missing database dump tools, make sure they are available on PATH, then retry bundle preparation.";
+        error55.userMessage = missingCommands.length === 1 ? createMissingDatabaseDumpToolError(missingCommands[0]).userMessage : "Install the missing database dump tools, make sure they are available on PATH, then retry the database copy.";
         return error55;
       }
       const executionErrors = failures.map((failure) => failure.error).filter(
@@ -306814,53 +306923,100 @@ var init_localPrepService = __esm({
       }
       return error55;
     };
+    buildDatabasePreflightArgs = ({ command, validationMode }) => {
+      if (validationMode !== "connection") {
+        return command.command === "pg_dump" ? ["--schema-only", ...command.args] : ["--no-data", ...command.args];
+      }
+      if (command.command === "pg_dump") {
+        return ["--schema-only", "--exclude-schema=*", ...command.args];
+      }
+      const connectionArgs = [];
+      for (let index = 0; index < command.args.length; index += 1) {
+        const arg2 = command.args[index];
+        if (arg2 === "--single-transaction" || arg2 === "--routines" || arg2 === "--events" || arg2 === "--triggers" || arg2 === "--skip-comments") {
+          continue;
+        }
+        if (arg2 === "--result-file") {
+          index += 1;
+          continue;
+        }
+        if (arg2.startsWith("--result-file=")) {
+          continue;
+        }
+        connectionArgs.push(arg2);
+      }
+      return [
+        "--no-data",
+        "--no-create-info",
+        "--skip-lock-tables",
+        ...connectionArgs
+      ];
+    };
     preflightDatabaseDumpCandidates = async ({
       candidates,
       databaseDumpToolResolver = null,
       databaseEnv,
       homeDir: homeDir2,
-      repoRoot
+      repoRoot,
+      validationMode = "schema"
     }) => {
       const tempRoot = await fs41.mkdtemp(
         path51.join(os25.tmpdir(), "boxes-database-preflight-")
       );
-      const failures = [];
+      const selectedCandidates = candidates.filter(
+        (candidate) => candidate?.canAutomate === true
+      );
+      const failuresByIndex = new Array(selectedCandidates.length).fill(null);
+      let nextCandidateIndex = 0;
       try {
-        for (const candidate of candidates) {
-          if (candidate?.canAutomate !== true) {
-            continue;
-          }
-          try {
-            const outputPath = path51.join(
-              tempRoot,
-              `${safeDatabaseDumpBaseName(candidate)}.${candidate.engine === "postgres" ? "dump" : "sql"}`
-            );
-            const command = await resolveDatabaseDumpCommand({
-              candidate,
-              databaseEnv,
-              homeDir: homeDir2,
-              outputPath,
-              repoRoot
-            });
-            const preflightArgs = command.command === "pg_dump" ? ["--schema-only", ...command.args] : ["--no-data", ...command.args];
-            await runDatabaseDumpCommand(command.command, preflightArgs, {
-              cwd: repoRoot,
-              databaseDumpToolResolver,
-              env: command.env
-            });
-          } catch (error55) {
-            failures.push({
-              candidateId: candidate.id ?? null,
-              label: candidate.displayLabel ?? candidate.id ?? "database",
-              message: toErrorMessage(error55),
-              code: error55 instanceof Error && typeof error55.desktopInitErrorCode === "string" ? error55.desktopInitErrorCode : null,
-              userMessage: error55 instanceof Error && typeof error55.userMessage === "string" ? error55.userMessage : null
-            });
+        const worker = async () => {
+          while (nextCandidateIndex < selectedCandidates.length) {
+            const candidateIndex = nextCandidateIndex;
+            nextCandidateIndex += 1;
+            const candidate = selectedCandidates[candidateIndex];
+            try {
+              const outputPath = path51.join(
+                tempRoot,
+                `${candidateIndex}-${safeDatabaseDumpBaseName(candidate)}.${candidate.engine === "postgres" ? "dump" : "sql"}`
+              );
+              const command = await resolveDatabaseDumpCommand({
+                candidate,
+                databaseEnv,
+                homeDir: homeDir2,
+                outputPath,
+                repoRoot
+              });
+              await runDatabaseDumpCommand(
+                command.command,
+                buildDatabasePreflightArgs({ command, validationMode }),
+                {
+                  cwd: repoRoot,
+                  databaseDumpToolResolver,
+                  env: command.env,
+                  timeoutMs: validationMode === "connection" ? DATABASE_APPROVAL_PREFLIGHT_TIMEOUT_MS : DATABASE_DUMP_TIMEOUT_MS
+                }
+              );
+            } catch (error55) {
+              failuresByIndex[candidateIndex] = {
+                ...createPublicDatabaseDumpFailure({ candidate, error: error55 }),
+                message: toErrorMessage(error55)
+              };
+            }
           }
-        }
+        };
+        const concurrency = validationMode === "connection" ? DATABASE_APPROVAL_PREFLIGHT_CONCURRENCY : 1;
+        await Promise.all(
+          Array.from(
+            {
+              length: Math.min(concurrency, selectedCandidates.length)
+            },
+            () => worker()
+          )
+        );
       } finally {
         await fs41.rm(tempRoot, { recursive: true, force: true });
       }
+      const failures = failuresByIndex.filter(Boolean);
       return { ok: failures.length === 0, failures };
     };
     createDatabasePayloads = async ({
@@ -311112,7 +311268,8 @@ var init_localPrepService = __esm({
             databaseDumpToolResolver,
             databaseEnv: capturedEnv.env,
             homeDir: homeDir2,
-            repoRoot: repo.repoRoot
+            repoRoot: repo.repoRoot,
+            validationMode: request2.databaseValidationMode === "connection" ? "connection" : "schema"
           });
         }),
         async getSnapshot(request2) {
@@ -328237,7 +328394,7 @@ var init_plan = __esm({
     };
     isDatabaseCopyCandidate2 = (value) => {
       if (!isObject10(value)) return false;
-      if (typeof value.id !== "string" || typeof value.engine !== "string" || typeof value.displayLabel !== "string" || typeof value.canAutomate !== "boolean" || typeof value.confidence !== "string" || !Array.isArray(value.evidence)) {
+      if (typeof value.id !== "string" || value.id.trim().length === 0 || typeof value.engine !== "string" || typeof value.displayLabel !== "string" || typeof value.canAutomate !== "boolean" || typeof value.confidence !== "string" || !Array.isArray(value.evidence)) {
         return false;
       }
       const source = value.source;
@@ -328273,7 +328430,8 @@ var init_plan = __esm({
     };
     isSetupDatabasesPlan = (value) => {
       if (!isObject10(value)) return false;
-      return typeof value.schemaVersion === "number" && typeof value.scanFullyCompleted === "boolean" && Array.isArray(value.databaseCandidates) && value.databaseCandidates.every(isDatabaseCopyCandidate2);
+      const databaseCandidates = Array.isArray(value.databaseCandidates) ? value.databaseCandidates : null;
+      return typeof value.schemaVersion === "number" && typeof value.scanFullyCompleted === "boolean" && databaseCandidates !== null && databaseCandidates.every(isDatabaseCopyCandidate2) && new Set(databaseCandidates.map((candidate) => candidate.id)).size === databaseCandidates.length;
     };
     isServicesPlan = (value) => {
       if (!isObject10(value)) return false;
@@ -357351,4 +357509,4 @@ react/cjs/react-jsx-runtime.development.js:
    *)
 */
 
-//# debugId=a55a831a-e9eb-5e0c-9e31-0c4bceb58a84
+//# debugId=622a15c0-7c29-5be9-a35c-b1a193a6b0f0

package/dist/bin/dvbd.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!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]="9fe1a110-cbff-5659-8dbf-ea5f546fb817")}catch(e){}}();
+!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]="273915e4-19f9-5515-bec4-e13639bb51de")}catch(e){}}();
 import { createRequire as __dvbCreateRequire } from "node:module";
 import { dirname as __dvbDirname } from "node:path";
 import { fileURLToPath as __dvbFileURLToPath } from "node:url";
@@ -96328,8 +96328,8 @@ var init_otel = __esm({
       return trimmed && trimmed.length > 0 ? trimmed : void 0;
     };
     readBuildMetadata = () => {
-      const rawPackageVersion = "1.0.957";
-      const rawGitSha = "bd2eee580a498b70adca3fcd0e8c9d25eb248aaf";
+      const rawPackageVersion = "1.0.959";
+      const rawGitSha = "c5992d38486ffdbc188773dfe7556175ffb24abc";
       const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
       const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
       return { packageVersion, gitSha };
@@ -128624,9 +128624,9 @@ var init_sentry = __esm({
     uncaughtExceptionMonitorInstalled = false;
     currentDevboxSentryUser = null;
     readBuildMetadata2 = () => {
-      const rawPackageVersion = "1.0.957";
-      const rawGitSha = "bd2eee580a498b70adca3fcd0e8c9d25eb248aaf";
-      const rawSentryRelease = "boxes-dev-dvb@1.0.957+bd2eee580a498b70adca3fcd0e8c9d25eb248aaf";
+      const rawPackageVersion = "1.0.959";
+      const rawGitSha = "c5992d38486ffdbc188773dfe7556175ffb24abc";
+      const rawSentryRelease = "boxes-dev-dvb@1.0.959+c5992d38486ffdbc188773dfe7556175ffb24abc";
       const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
       const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
       const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -130818,7 +130818,7 @@ var init_packageVersion = __esm({
       return path8.join(process.cwd(), "dvb");
     };
     readEmbeddedPackageVersion = () => {
-      const raw = "1.0.957";
+      const raw = "1.0.959";
       return trimVersion(raw);
     };
     readNearestPackageMetadata = (basePath) => {
@@ -144013,4 +144013,4 @@ long/umd/index.js:
    *)
 */
 
-//# debugId=9fe1a110-cbff-5659-8dbf-ea5f546fb817
+//# debugId=273915e4-19f9-5515-bec4-e13639bb51de

package/dist/product-docs/references/onbox-agent-tools.md

@@ -30,6 +30,10 @@ authority, and an unassociated box receives no targets.
 
 ## Current Box Role
 
+Every managed agent, terminal, and child process receives `BOXES_DEVBOX=1` on
+both Template boxes and ordinary devboxes. Use this presence flag when a tool
+or skill only needs to know that it is running in a boxes.dev environment.
+
 An on-box agent can read whether it is running on the project's Template box or
 an ordinary devbox without contacting or waking another machine:
 
@@ -401,10 +405,11 @@ dvb-onbox threads read \
   --json
 ```
 
-This returns the durable boxes.dev transcript projection, thread status, and
-older-page cursor. It can briefly lag the live runtime. Pending Codex and Claude
-queue entries remain runtime state and do not appear as transcript messages
-until the provider accepts them as turns.
+This returns a bounded preview of the durable boxes.dev transcript, thread
+status, and older-page cursor. Long messages are marked as shortened. It can
+briefly lag the live runtime. Pending Codex and Claude queue entries remain
+runtime state and do not appear as transcript messages until the provider
+accepts them as turns.
 
 List and observe that same source-scoped child pool without waking a child
 devbox:
@@ -412,6 +417,10 @@ devbox:
 ```bash
 dvb-onbox threads list [--include-archived] [--cursor <cursor> | --all] --json
 
+dvb-onbox threads result <delegated-thread-id> \
+  --turn <turn-id> \
+  --json
+
 dvb-onbox threads wait <delegated-thread-id> \
   [--turn <turn-id>] \
   [--timeout <duration>] \
@@ -424,15 +433,19 @@ dvb-onbox threads events <delegated-thread-id> \
 
 `threads list` uses the current source box's project automatically and never
 shows other project threads, including children created by a different source
-box. `threads wait` snapshots the current active turn once when `--turn` is
-omitted; Ctrl+C stops only the local wait. `threads events` emits durable
-lifecycle events with an opaque resume cursor on every JSONL row. With no turn,
-cursor, or `--from-start`, it follows only events created after the command
-starts. An exact-turn stream ends after needs-input or a terminal event.
-
-Read, list, wait, and events operate on durable control-service state, so they
-can inspect archived, cold, and history-only children without waking their
-devboxes or claiming a live input surface. The source box's live **Create
+box. `threads result` returns the complete stored final response for one exact
+terminal turn and automatically assembles its transport pages. Use it instead
+of asking the child to summarize a shortened `threads read` preview. When
+`threads wait` omits `--turn`, it snapshots the current active turn once. A
+completed wait includes that same complete response as `output.text`; Ctrl+C
+stops only the local wait. `threads events` emits durable lifecycle events with
+an opaque resume cursor on every JSONL row. With no turn, cursor, or
+`--from-start`, it follows only events created after the command starts. An
+exact-turn stream ends after needs-input or a terminal event.
+
+Read, result, list, wait, and events operate on durable control-service state,
+so they can inspect archived, cold, and history-only children without waking
+their devboxes or claiming a live input surface. The source box's live **Create
 devboxes and threads** permission is checked on every observation and control.
 Prompt files are limited to 32 KiB.
 

package/dist/product-docs/references/project-setup.md

@@ -395,6 +395,14 @@ The review page also has an optional freeform note for anything the setup coding
 agent should know; that note is included in the approved setup plan for the
 Template box setup thread.
 
+When the user approves **Local database dumps**, desktop setup briefly checks
+each selected PostgreSQL or MySQL/MariaDB connection without copying database
+contents. If a database is stopped, missing, unreachable, or rejects the
+selected credentials, that row stays unapproved and explains what went wrong.
+The user can retry after starting the database, skip that database, or ask the
+scan agent once to correct its connection finding. Agent repair receives only
+credential-free connection diagnostics.
+
 When the scan finds an environment file, boxes.dev snapshots a copy of it at
 scan time and sends that copy to the Template box. Users can open any env file
 in an in-app editor and change exactly what gets sent (for example, removing a
@@ -448,12 +456,14 @@ copies. Setup continues to prefer a usable `pg_dump` already on `PATH`, then
 uses the included client when the host command is missing or is older than the
 source server. If the included payload is unavailable, or the Postgres server
 is newer than the included client, setup explains how to update or reinstall
-boxes.dev or use a compatible host client. The user can also continue without
-the database dump if the database copy is not essential. MySQL copies still
-require `mysqldump` on `PATH`. If a MySQL dump fails, setup explains how to use
-a client from the same MySQL or MariaDB family and major or LTS release as the
-local server. The user can retry after fixing the connection or client, or
-continue immediately without importing the local database data.
+boxes.dev or use a compatible host client. The user can also skip that database
+if its local data is not essential. MySQL copies still require `mysqldump` on
+`PATH`. If a MySQL dump fails, setup explains how to use a client from the same
+MySQL or MariaDB family and major or LTS release as the local server. The user
+can retry after fixing the connection or client, or skip the failed database
+and continue. When several database copies were selected, skipping removes only
+the copies that failed; successful selections remain in the setup bundle. Every
+full-dump failure is shown before upload rather than silently omitting its data.
 
 The bundle screen also shows size information and warns if the bundle is too
 large.
@@ -611,6 +621,15 @@ summary before it requests completion.
 
 Setup state is persisted so interrupted setup can usually be resumed.
 
+Interrupted desktop setups appear under **Setups in progress** in two places:
+below the setup options on the wizard's Project step, and in their own section
+of the titlebar project selector. Choosing an entry in either place will
+reopen setup at the step where it left off. The wizard row also offers
+**Continue setup** and a delete button; deleting removes only the incomplete
+setup state, and the local folder and its files won't be affected. A setup
+waiting on a recoverable error shows **Needs attention** in the project
+selector.
+
 Common recovery paths:
 
 - Existing completed project: open the existing project.

package/dist/prompts/local-scan-databases.md

@@ -73,7 +73,7 @@ Return JSON with this shape:
 
 Each `databaseCandidates` entry must include:
 
-- `id`: stable short slug
+- `id`: non-empty stable short slug, unique within `databaseCandidates`
 - `engine`: `postgres` or `mysql`
 - `displayLabel`: concise user-facing label for approval UI
 - `source`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boxes-dev/dvb-runtime",
-  "version": "1.0.957",
+  "version": "1.0.959",
   "type": "module",
   "license": "UNLICENSED",
   "imports": {
@@ -77,5 +77,5 @@
     "e2b": "^2.18.0",
     "ink-testing-library": "^4.0.0"
   },
-  "devboxReleasedAt": "2026-08-26T22:05:52Z"
+  "devboxReleasedAt": "2026-08-27T22:42:48Z"
 }