@datarails-ai/dr-cli 1.6.137 → 1.6.138

package/dist/cli.js

@@ -8,7 +8,7 @@ import { fileURLToPath as fileURLToPath3 } from "url";
 // package.json
 var package_default = {
   name: "@datarails-ai/dr-cli",
-  version: "1.6.137",
+  version: "1.6.138",
   description: "Datarails CLI",
   type: "module",
   engines: {
@@ -69,7 +69,7 @@ var package_default = {
 };
 
 // src/buildInfo.ts
-var BUILD_TIME = "2026-10-15T19:39:28.907Z";
+var BUILD_TIME = "2026-10-15T20:14:54.448Z";
 function formatBuildTime(iso) {
   if (iso === "") return "";
   const d = new Date(iso);
@@ -33166,7 +33166,7 @@ async function runPreviewData(cfg) {
   const result = await previewData(cfg.client, body, { signal: cfg.signal });
   writeJSONIndented(cfg.out, result);
 }
-async function findOrdinalCollisions(client, mapperId, docIds, signal) {
+async function findBindingLosses(client, mapperId, docIds, signal) {
   const details = await getDetails2(client, mapperId, { signal });
   const tableId = details.template.id;
   const mappers = await list20(client, tableId, { signal });
@@ -33179,9 +33179,10 @@ async function findOrdinalCollisions(client, mapperId, docIds, signal) {
   const others = mappers.filter(
     (m) => m.id !== mapperId && (m.ordinal ?? null) === ordinal && (m.mapped_documents_ids ?? []).some((d) => wanted.has(d))
   );
-  return { tableId, ordinal, others };
+  const dropped = (self.mapped_documents_ids ?? []).filter((d) => !wanted.has(d));
+  return { tableId, ordinal, others, dropped };
 }
-async function warnOrdinalCollisions(cfg, body) {
+async function warnBindingLosses(cfg, body) {
   const err = cfg.err ?? process.stderr;
   const raw = body["selected_document_ids"];
   const docIds = (Array.isArray(raw) ? raw : []).map((d) => {
@@ -33193,24 +33194,34 @@ async function warnOrdinalCollisions(cfg, body) {
     }
     return n;
   });
-  if (docIds.length === 0) {
+  if (!Array.isArray(raw)) {
     return;
   }
   let found;
   try {
-    found = await findOrdinalCollisions(cfg.client, cfg.mapperId, docIds, cfg.signal);
+    found = await findBindingLosses(cfg.client, cfg.mapperId, docIds, cfg.signal);
   } catch (e) {
     if (cfg.signal.aborted) {
       throw e;
     }
+    err.write(`note: could not check what this bind unbinds: ${e.message}
+`);
+    return;
+  }
+  if (found === null) {
     err.write(
-      `note: could not check for other mappers on the same ordinal: ${e.message}
+      `note: mapper ${cfg.mapperId} is not in its table's mapper list, so dr could not check what this bind unbinds. The document list replaces its current documents.
 `
     );
     return;
   }
-  if (found === null) {
-    return;
+  if (found.dropped.length > 0) {
+    const all = [.../* @__PURE__ */ new Set([...found.dropped, ...docIds])];
+    const keep = cfg.payloadFile.trim() === "" ? all.map((d) => `--doc ${d}`).join(" ") : `"selected_document_ids": [${all.join(", ")}]`;
+    err.write(
+      `warning: the document list replaces mapper ${cfg.mapperId}'s current documents, so this bind unbinds mapper ${cfg.mapperId} from document(s) [${found.dropped.join(", ")}]. To keep them, list every document you want bound: ${keep}
+`
+    );
   }
   const ordinal = found.ordinal === null ? "null" : String(found.ordinal);
   for (const other of found.others) {
@@ -33245,7 +33256,7 @@ async function runUpdateBinding(cfg) {
       body["rescan"] = r;
     }
   }
-  await warnOrdinalCollisions(cfg, body);
+  await warnBindingLosses(cfg, body);
   const result = await updateBinding(cfg.client, cfg.mapperId, body, {
     signal: cfg.signal
   });
@@ -34303,7 +34314,7 @@ function registerDatamappersCommand(root) {
   addServerFlag(previewCmd);
   addAccountFlag(previewCmd);
   const bindCmd = dm.command("bind").description(
-    'Update which document IDs a mapper is bound to. Posts to `POST /api/templates/mappers/<id>/binding` with `{selected_document_ids, rescan?}`. The legacy webclient\'s "Mapping table with documents" modal calls this when the operator checks/unchecks docs in the binding picker. Warns first when another mapper of the table on the same ordinal is bound to one of those docs: mappers that share an ordinal are versions of one mapper, so the bind unbinds the other.'
+    "Update which document IDs a mapper is bound to. The --doc list replaces the mapper's current documents; repeat every filebox you want to keep (dr warns first and names any it drops). Posts to `POST /api/templates/mappers/<id>/binding` with `{selected_document_ids, rescan?}`. The legacy webclient's \"Mapping table with documents\" modal calls this when the operator checks/unchecks docs in the binding picker. Warns first when another mapper of the table on the same ordinal is bound to one of those docs: mappers that share an ordinal are versions of one mapper, so the bind unbinds the other."
   ).argument("<mapper_id>", "mapper id (positive integer)").option("--doc <id>", "Document id to bind (positive integer; repeatable)", collectInts, []).option(
     "--rescan <mode>",
     "Trigger a re-extraction: `latest` or `all` (default: omit; no rescan)",

package/dist/scopes-map.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "cliVersion": "1.6.137",
+  "cliVersion": "1.6.138",
   "_contract": "Resolve a command path through `aliases` (canonical prefix + alias segment -> canonical path) before any lookup. A path listed in `pendingCommands`, or whose first segment is a key of `pending`, is UNDECIDED, not unrestricted: fail closed or skip it, and never read a path's absence from `commands` as 'no requirement'. An entry carrying `denied` is UNAVAILABLE to any AGENT-SCOPED credential — one whose `scopes` claim carries at least one `resource:action` entry; a claim that is absent, empty, capability-only or wholly unparseable is UNRESTRICTED, and this mark does not apply to it — whatever else that entry says: it is not a ceiling and it is not always-available, its `denied.reason` says why and `denied.until` names the ticket that lifts it, and the absence of `requires` on it must NEVER be read as 'no requirement'. Only an entry in `commands` with an empty `requires` means always-available.",
   "commands": {
     "login": {

package/dist/skills/dr-cli/reference/datamappers.md

@@ -124,7 +124,9 @@ value-inference behavior. `NAME` is the target **table field** name (the
 - `datamappers preview --payload-file <p>` — renders mapper output for sample
   input ("what would this extract?") before saving.
 - `datamappers bind <mapper_id> --doc <id> [--rescan latest|all]` — change which
-  docs a mapper is bound to. A doc bound to another mapper of the table on the
+  docs a mapper is bound to. The --doc list replaces the mapper's current
+  documents; repeat every filebox you want to keep. dr warns first and names any
+  bound filebox the list drops. A doc bound to another mapper of the table on the
   same ordinal moves to this one (see *Ordinal* above), and dr warns first.
 
 ### `update --field NAME:TYPE` — set column types (materialising calc columns)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datarails-ai/dr-cli",
-  "version": "1.6.137",
+  "version": "1.6.138",
   "description": "Datarails CLI",
   "type": "module",
   "engines": {