@dboio/cli 0.6.6 → 0.6.8

package/README.md

@@ -128,11 +128,12 @@ All configuration is **directory-scoped**. Each project folder maintains its own
 |------|---------|-----|
 | `config.json` | Domain, app metadata, placement preferences | Committable (shared) |
 | `config.local.json` | Per-user settings: plugin scopes, future user prefs | Gitignored (per-user) |
+| `ticketing.local.json` | Stored ticket IDs for submission error recovery | Gitignored (per-user) |
 | `credentials.json` | Username, user ID, UID, name, email (no password) | Gitignored (per-user) |
 | `cookies.txt` | Session cookie (Netscape format) | Gitignored (per-user) |
 | `structure.json` | Bin directory mapping (created by `dbo clone`) | Committable (shared) |
 
-`dbo init` automatically adds `.dbo/credentials.json`, `.dbo/cookies.txt`, and `.dbo/config.local.json` to `.gitignore` (creates the file if it doesn't exist).
+`dbo init` automatically adds `.dbo/credentials.json`, `.dbo/cookies.txt`, `.dbo/config.local.json`, and `.dbo/ticketing.local.json` to `.gitignore` (creates the file if it doesn't exist).
 
 #### config.json reference
 
@@ -252,6 +253,34 @@ dbo init --domain my-domain.com --app myapp --clone
 
 When cloning an app that was already cloned locally, the CLI detects existing files and compares modification times against the server's `_LastUpdated`. You'll be prompted to overwrite, compare differences, or skip — same as `dbo pull`. Use `-y` to auto-accept all changes.
 
+#### Collision detection
+
+When multiple records would create files at the same path (e.g., a `content` record and a `media` record both named `colors.css`), the CLI detects the collision before writing any files and prompts you to choose which record to keep:
+
+```
+⚠ Collision: 2 records want to create "Bins/app/colors.css"
+? Which record should create this file?
+❯ [content] colors (UID: abc123)
+  [media] colors.css (UID: def456)
+```
+
+The rejected record is automatically staged for deletion in `.dbo/synchronize.json`. Run `dbo push` to delete it from the server.
+
+In non-interactive mode (`-y`), the first record is kept and others are auto-staged for deletion.
+
+#### Stale media cleanup
+
+During media downloads, files returning 404 (no longer exist on the server) are collected as "stale records". After all downloads complete, you'll be prompted to stage them for deletion:
+
+```
+Found 3 stale media record(s) (404 - files no longer exist on server)
+? Stage these 3 stale media records for deletion? (y/N)
+```
+
+This helps keep your app clean by removing database records for media files that have been deleted from the server.
+
+In non-interactive mode (`-y`), stale cleanup is skipped (conservative default).
+
 #### Path resolution
 
 When a content record has both `Path` and `BinID`, the CLI prompts:
@@ -1090,7 +1119,35 @@ The `add` and `push` commands never submit these server-managed columns:
 
 The `input`, `push`, and `add` commands automatically detect recoverable server errors and prompt for missing values instead of failing immediately.
 
-#### Ticket ID required
+#### Ticket error recovery
+
+When the server returns a `ticket_error` (record update requires a Ticket ID), the CLI prompts with interactive recovery options:
+
+```
+⚠ This record update requires a Ticket ID.
+? Record update requires a Ticket ID:
+❯ Apply a Ticket ID to this record and resubmit
+  Apply a Ticket ID to all updates in this transaction, and update my current Ticket ID reference
+  Skip this record update
+  Skip all updates that require a Ticket ID
+```
+
+When the server returns a `repo_mismatch` (Ticket ID belongs to a different repository), the CLI prompts:
+
+```
+⚠ Ticket "TICKET-123" is for another repository.
+? The Ticket ID of "TICKET-123" is for another Repository:
+❯ Commit anyway
+  Submit with another Ticket ID
+  Skip this record
+  Commit all transactions with this ID anyway
+  Commit all transactions with another Ticket ID, and update my current Ticket ID reference
+  Skip all
+```
+
+Ticket selections are stored in `.dbo/ticketing.local.json` for reuse across submissions. Per-record tickets are cleaned up after successful submission; the global ticket persists until explicitly cleared. The `--ticket` flag always takes precedence over stored tickets.
+
+#### Ticket ID required (legacy)
 
 When the server returns `ticket_lookup_required_error`, the CLI prompts:
 
@@ -1101,6 +1158,40 @@ When the server returns `ticket_lookup_required_error`, the CLI prompts:
 
 The submission is then retried with `_OverrideTicketID`. To skip the prompt, pass `--ticket <id>` upfront.
 
+#### Pre-submission ticket prompt
+
+When a stored ticket exists in `.dbo/ticketing.local.json`, the CLI prompts before batch submissions:
+
+```
+? Use stored Ticket ID "TICKET-123" for this submission?
+❯ Yes, use "TICKET-123"
+  No, clear stored ticket
+  Cancel submission
+```
+
+#### `.dbo/ticketing.local.json`
+
+Stores ticket IDs for automatic application during submissions:
+
+```json
+{
+  "ticket_id": "TICKET-123",
+  "records": [
+    {
+      "UID": "a2dxvg23rk6xsmnum7pdxa",
+      "RowID": 16012,
+      "entity": "content",
+      "ticket_id": "TICKET-456",
+      "expression": "RowID:16012;column:content._LastUpdatedTicketID=TICKET-456"
+    }
+  ]
+}
+```
+
+- `ticket_id` — Global ticket applied to all submissions until cleared
+- `records` — Per-record tickets (auto-cleared after successful submission)
+- `--ticket` flag always takes precedence over stored tickets
+
 #### User identity required
 
 When the server returns an error mentioning `LoggedInUser_UID`, `LoggedInUserID`, `CurrentUserID`, or `UserID`, the CLI checks for a stored user identity from `dbo login`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dboio/cli",
-  "version": "0.6.6",
+  "version": "0.6.8",
   "description": "CLI for the DBO.io framework",
   "type": "module",
   "bin": {

package/plugins/claude/dbo/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dbo",
-  "version": "0.6.6",
+  "version": "0.6.8",
   "description": "DBO.io CLI integration for Claude Code",
   "author": {
     "name": "DBO.io"

package/src/commands/add.js

@@ -7,6 +7,7 @@ import { formatResponse, formatError } from '../lib/formatter.js';
 import { log } from '../lib/logger.js';
 import { shouldSkipColumn } from '../lib/columns.js';
 import { loadAppConfig } from '../lib/config.js';
+import { checkStoredTicket, clearGlobalTicket } from '../lib/ticketing.js';
 
 // Directories and patterns to skip when scanning with `dbo add .`
 const IGNORE_DIRS = new Set(['.dbo', '.git', 'node_modules', '.svn', '.hg']);
@@ -245,10 +246,21 @@ async function submitAdd(meta, metaPath, filePath, client, options) {
   let body = await buildInputBody(dataExprs, extraParams);
   let result = await client.postUrlEncoded('/api/input/submit', body);
 
-  // Retry with prompted params if needed (ticket, user)
-  const retryParams = await checkSubmitErrors(result);
-  if (retryParams) {
-    Object.assign(extraParams, retryParams);
+  // Retry with prompted params if needed (ticket, user, repo mismatch)
+  const retryResult = await checkSubmitErrors(result);
+  if (retryResult) {
+    if (retryResult.skipRecord) {
+      log.warn('  Skipping record');
+      return null;
+    }
+    if (retryResult.skipAll) {
+      throw new Error('SKIP_ALL');
+    }
+    if (retryResult.ticketExpressions?.length > 0) {
+      dataExprs.push(...retryResult.ticketExpressions);
+    }
+    const params = retryResult.retryParams || retryResult;
+    Object.assign(extraParams, params);
     body = await buildInputBody(dataExprs, extraParams);
     result = await client.postUrlEncoded('/api/input/submit', body);
   }
@@ -302,6 +314,19 @@ async function addDirectory(dirPath, client, options) {
     if (!proceed) return;
   }
 
+  // Pre-flight ticket validation
+  if (!options.ticket) {
+    const ticketCheck = await checkStoredTicket(options);
+    if (ticketCheck.cancel) {
+      log.info('Submission cancelled');
+      return;
+    }
+    if (ticketCheck.clearTicket) {
+      await clearGlobalTicket();
+      log.dim('  Cleared stored ticket');
+    }
+  }
+
   let succeeded = 0;
   let failed = 0;
   let batchDefaults = null;
@@ -314,6 +339,10 @@ async function addDirectory(dirPath, client, options) {
         succeeded++;
       }
     } catch (err) {
+      if (err.message === 'SKIP_ALL') {
+        log.info('Skipping remaining records');
+        break;
+      }
       log.error(`Failed: ${relative(process.cwd(), filePath)} — ${err.message}`);
       failed++;
     }