record_batch_job
Record a batch operation on a set of files and return a dry-run preview of changes for human approval before execution.
Instructions
Registra un BatchJob (UN verbo determinista sobre un conjunto de archivos) y devuelve una VISTA PREVIA EN SECO (old→new por archivo) SIN mutar nada — esa vista previa ES la aprobación humana a escala (no se aprueban 70k archivos uno por uno; se aprueba verbo + alcance + el diff). Revísala; luego ejecútalo con run_batch_job.
Args: intent: Una oración: ¿qué cambio masivo es? fileset: {root, glob?, recurse?, paths?, exclude?, confidence?} — la carpeta (+filtro) o una lista explícita de rutas. Resolver el alcance lee SOLO metadatos de ruta; la geometría no se transmite. operation: {verb, params} — verb ∈ set_custom_property / export_document / force_rebuild / check_interference / get_bom. Ej: {"verb":"set_custom_property", "params":{"name":"Proveedor","value":"ACME","config":""}}. save_after: guardar cada archivo tras un verbo que modifica el documento (p.ej. set_custom_property). export/health/BOM no guardan el origen. continue_on_error: True → un archivo malo no aborta el lote (cada salto se reporta en el manifiesto). out_dir: carpeta ÚNICA para las salidas (export/BOM) y el manifiesto ("" = junto al origen). Una ruta de red aquí dispara una advertencia (la geometría no debe salir del host). confidence: 0–10 del plan (afecta go_recommendation: <6 → handback). preview_cap: máximo de filas en la vista previa.
Devuelve {batch_job_id, matched_files, preview, preview_truncated, warnings, go_recommendation}. [en: Record a batch job + return a dry-run preview — advisory only; review, then run_batch_job.]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| intent | Yes | ||
| fileset | Yes | ||
| out_dir | No | ||
| operation | Yes | ||
| confidence | No | ||
| save_after | No | ||
| preview_cap | No | ||
| continue_on_error | No |