Auditoria integral: modelo semantico + informe + layout.

Devuelve puntaje global y por dominio, resumen ejecutivo, hallazgos priorizados con evidencia y recomendacion, y que reglas tienen correccion automatica.

formats: ['markdown','html'] escribe tambien esos informes en outputs/ y devuelve sus rutas. rules y min_severity acotan.

Audita solo el informe PBIR (sin las reglas del modelo semantico).

Cubre paginas vacias, visuales sin titulo, campos rotos, duplicados, tamanos de lienzo inconsistentes y la geometria de cada pagina.

Planifica correcciones para reglas CONCRETAS. No escribe nada.

No existe "arreglar todo": hay que indicar rules explicitamente. objects acota mas todavia (ids de visual o de pagina). Devuelve las acciones exactas que se aplicarian, con su motivo.

Aplica las acciones devueltas por pbi_plan_audit_fixes.

Requiere confirm=true. Cada accion se aplica por su propia via segura (transaccion, verificacion y rollback); si una falla, se reporta sin detener las demas y sin ocultarlo.

Reglas que tienen correccion automatica, y en que consiste cada una.

Lista los modelos de Power BI Desktop abiertos localmente.

Detecta el motor de Analysis Services (localhost:) de cada informe abierto y devuelve puerto, connection string, catalogo y nº de tablas.

Selecciona el modelo local activo para futuras operaciones.

Si hay un solo modelo abierto no hace falta indicar puerto. Si hay varios, pasa el port (visto en pbi_list_desktop_models).

Ejecuta una consulta DAX de SOLO LECTURA contra el modelo activo.

Solo se admiten formas reconocidas: EVALUATE, DEFINE...EVALUATE y DMVs de $SYSTEM. Cualquier otra cosa se rechaza (politica fail-closed).

max_rows: limite de filas. max_bytes: tope de tamano del resultado, para no devolver megas al cliente. timeout_seconds: timeout del comando. export=true vuelca el resultado completo a outputs/ y devuelve la ruta.

Devuelve columnas, tipos observados, filas, estadisticas de ejecucion y si se trunco (y por que: filas o tamano). Los errores DAX del motor se devuelven tal cual.

Valida la conexion al modelo activo con una consulta trivial.

Valida DAX de medidas SIN modificar el modelo (dry-run con DEFINE MEASURE).

Ideal para probar medidas ANTES de crearlas con pbi_create_measure. measures: lista de {"name","dax","table"(opcional)}. Las medidas pueden referenciarse entre si. Devuelve por cada una: valid, value (muestra) y error.

Lista tablas con columnas, tipos, visibilidad y conteos.

source: 'live' (modelo abierto, por defecto) o 'pbip' (archivos TMDL).

Lista medidas con tabla, expresion DAX, formato, descripcion y carpeta.

Lista relaciones: tablas/columnas, cardinalidad, filtro cruzado y estado.

Detecta problemas tipicos del modelo (calidad).

Revisa medidas sin carpeta, DAX muy largo, relaciones bidireccionales/ inactivas, columnas calculadas, IDs visibles, ausencia de calendario, etc.

Genera documentacion completa del modelo en Markdown.

Incluye resumen, tablas, columnas, medidas, relaciones, jerarquias, roles (RLS) y advertencias de calidad. Guarda el archivo en outputs/.

Resumen compacto del modelo, pensado para leerlo de un vistazo.

Conteos, tablas con su tamano, medidas por tabla, columnas calculadas, tablas desconectadas, relaciones bidireccionales y referencias rotas. Es la primera tool que conviene llamar para orientarse en un modelo. source: 'live' (Desktop abierto) o 'pbip' (archivos TMDL).

Busca objetos del modelo por nombre (y en el DAX de las medidas).

term: texto a buscar, sin distinguir mayusculas. kinds: filtra por tipo — table, column, measure, hierarchy, role. Para las medidas indica si coincidio el nombre o la expresion.

Devuelve un objeto del modelo con todo su detalle.

kind: table | column | measure. Para una columna usa 'Tabla[Columna]'. En una medida incluye ademas las referencias que aparecen en su DAX.

De que depende una medida y quien depende de ella.

Devuelve dependencias directas (medidas, columnas y referencias ROTAS), el cierre transitivo sobre medidas hasta depth, y la lista de medidas que la usan. Analisis lexico: detecta referencias escritas, no las construidas dinamicamente.

Que usa una columna: medidas, columnas calculadas, relaciones y jerarquias.

Util antes de ocultar o eliminar una columna: dice si algo se rompe.

Lista las jerarquias del modelo con sus niveles y columnas.

Lista los roles de seguridad (RLS) y sus filtros por tabla.

Lista las perspectivas del modelo.

Requiere la capa EN VIVO: el lector TMDL de este proyecto no las extrae. Si no hay ninguna, devuelve una lista vacia con la explicacion.

Lista las particiones por tabla (modo de almacenamiento y origen).

Audita el modelo semantico con reglas de identificador estable.

Cada hallazgo trae rule, severity, object, evidence, recommendation y auto_fix_available. Ninguna heuristica se presenta como certeza: la evidencia acompana siempre al hallazgo. rules: subconjunto de reglas (ver pbi_list_audit_rules). min_severity: info | warning | error.

Catalogo de reglas de auditoria disponibles, con su dominio y severidad.

Crea (o reemplaza con overwrite=true) una medida DAX.

Valida que la tabla exista y que la medida no exista salvo overwrite. data_category: opcional, p.ej. "ImageUrl" para medidas que devuelven un data-URI SVG (Power BI las renderiza como imagen en tablas/matrices). Devuelve el diff antes/despues.

mode='both' esta temporalmente deshabilitado bajo la politica estricta: 'live' necesita Power BI Desktop abierto y 'pbip' lo necesita cerrado, asi que una sola llamada aplicaria solo uno de los dos destinos. Elige 'live' o 'pbip'.

Actualiza una medida existente. Lo no especificado se conserva.

mode='both' esta temporalmente deshabilitado bajo la politica estricta: 'live' necesita Power BI Desktop abierto y 'pbip' lo necesita cerrado, asi que una sola llamada aplicaria solo uno de los dos destinos. Elige 'live' o 'pbip'.

Elimina una medida. Operacion destructiva: requiere confirm=true.

mode='both' esta temporalmente deshabilitado bajo la politica estricta: 'live' necesita Power BI Desktop abierto y 'pbip' lo necesita cerrado, asi que una sola llamada aplicaria solo uno de los dos destinos. Elige 'live' o 'pbip'.

Oculta o muestra una columna del modelo (p.ej. ocultar columnas de ID).

mode='both' esta temporalmente deshabilitado bajo la politica estricta: 'live' necesita Power BI Desktop abierto y 'pbip' lo necesita cerrado, asi que una sola llamada aplicaria solo uno de los dos destinos. Elige 'live' o 'pbip'.

Oculta/muestra VARIAS columnas como un solo lote.

columns: lista de {"table": ..., "column": ...}.

Valida todas las entradas antes de escribir: si alguna tabla o columna no existe, no se modifica nada y el error indica el indice. Los archivos TMDL se escriben en una sola transaccion y el modelo en vivo con un solo SaveChanges. count es el numero de entradas SOLICITADAS (incluidos duplicados); results trae una entrada por cada una, en el mismo orden.

mode='both' esta temporalmente deshabilitado bajo la politica estricta: 'live' necesita Power BI Desktop abierto y 'pbip' lo necesita cerrado, asi que una sola llamada aplicaria solo uno de los dos destinos. Elige 'live' o 'pbip'.

Cambia el filtro cruzado de una relacion.

direction: 'single' (una direccion, recomendado) o 'both' (bidireccional). OJO: cambiar a 'single' puede alterar totales que dependian de la bidireccional; verifica el informe despues.

No confundir direction='both' (bidireccional, valido) con mode='both', que esta temporalmente deshabilitado bajo la politica estricta: 'live' necesita Power BI Desktop abierto y 'pbip' lo necesita cerrado, asi que una sola llamada aplicaria solo uno de los dos destinos.

Activa/desactiva 'Auto fecha y hora' (solo modo pbip).

Desactivarlo aligera el modelo: al reabrir el .pbip, Power BI elimina las tablas de fecha automaticas (LocalDateTable_*). Requiere proyecto .pbip activo.

Estado general del servidor: dependencias, DLLs, sesion y proyecto.

Solo lectura. Es lo primero que conviene llamar: dice si la capa EN VIVO esta disponible, si hay un proyecto .pbip abierto y si algo requiere atencion (sesion obsoleta, journals pendientes).

Que puede hacerse AHORA MISMO, y que no, con el motivo.

Un agente deberia consultarla antes de planificar: dice si la capa en vivo esta disponible, si se puede escribir en el .pbip, y que capacidades dependen de la version del motor.

Detalle de la sesion: modelo activo, proyecto activo y su frescura.

Distingue una sesion valida de una obsoleta (stale) o de otra que ocupo el mismo puerto (mismatch).

Lista los journals del proyecto activo.

Un journal pending es el de una operacion que ni se confirmo ni se revirtio (el proceso murio en medio). Contiene los originales. only_pending=false lista tambien los ya cerrados.

Inspecciona un journal y lo compara con el estado ACTUAL del proyecto.

Solo lectura: no restaura nada. Por cada archivo dice si sigue como el original, si hay respaldo disponible y cual fue su desenlace. journal: ruta devuelta por pbi_list_pending_journals.

Restaura los originales guardados en un journal. DESTRUCTIVA.

Sin confirm devuelve la VISTA PREVIA: que archivos se restaurarian, cual es su estado actual y si alguien los cambio despues.

Estados: recoverable, recovered, conflict, incomplete, corrupted. Si un archivo cambio despues de la transaccion, se rechaza con recovery_conflict en vez de pisar ese trabajo; force_conflict lo aplica de todas formas.

Cada archivo se verifica byte a byte tras restaurarlo, y se recrean los directorios padre que hubieran desaparecido.

Aplica la politica de retencion a los backups. DESTRUCTIVA.

Sin confirm devuelve el MANIFIESTO de lo que se eliminaria, sin tocar nada. Solo se borran directorios de journal reconocibles (con su manifest.json) dentro de la carpeta de backups del proyecto activo: nunca un archivo suelto, ni un enlace simbolico, ni una raiz amplia.

Se conserva siempre el journal mas reciente y TODOS los pendientes: un journal pendiente guarda los unicos originales de una transaccion que no llego a cerrarse.

Calcula un PLAN sin aplicar nada, y devuelve un plan_token.

operation: una de las que lista pbi_capabilities en planned_operations. arguments: los mismos que aceptaria la tool.

El plan incluye el diff por archivo y una huella del estado sobre el que se calculo. Si el proyecto cambia despues, pbi_apply_plan lo rechaza.

Aplica un plan calculado con pbi_plan_change o con un dry_run.

Verifica que el proyecto siga en el estado sobre el que se planifico; si cambio, rechaza el plan en vez de aplicar algo distinto de lo aprobado.

expected_operation es opcional: si lo indicas, el plan solo se aplica si fue generado para esa operacion (plan_operation_mismatch si no).

Entrega el material para diseniar una hoja: modelo (tablas/medidas/columnas), catalogo de visuales existentes (reutilizables como plantilla), canvas y paginas.

Usa esto ANTES de proponer una hoja: te dice que campos y tipos de visual hay.

Genera una MAQUETA HTML de una hoja propuesta (sin escribir nada al .pbip).

spec: {page_name, canvas?, layout?, visuals:[{type,title,fields,position?}]}. Devuelve la ruta del HTML (abrelo en el navegador para revisar el diseno).

Exporta una MAQUETA HTML de una pagina EXISTENTE (layout + campos de cada visual).

Crea una hoja (pagina) PBIR completa a partir de un spec.

spec: {page_name, canvas?, layout?(grid|dashboard|executive_summary), visuals:[{type,title,fields:{rol:refs},position?}]}. Clona visuales existentes del mismo tipo como plantilla. Hace backup. Omite 'position' en un visual para que se auto-acomode con 'layout'.

Abre un proyecto .pbip y lo marca como proyecto activo.

Detecta carpetas .SemanticModel (TMDL) y .Report (PBIR) y devuelve un resumen con advertencias (p.ej. si el informe no usa PBIR). path: ruta al archivo .pbip o a su carpeta.

Valida a fondo el proyecto .pbip activo (estructura, PBIR, TMDL).

Crea un backup con timestamp del proyecto .pbip activo.

mode: folder | zip. scope: report | model | both. Devuelve la ruta.

Refresca el modelo LOCAL abierto en Power BI Desktop (no el Service).

type: full | calculate | clear_values (tambien automatic | data_only). tables: lista opcional de tablas a refrescar; si se omite, todo el modelo. Devuelve estado y duracion. Los errores de credenciales/origen se reportan.

Definicion completa y normalizada de un visual.

Devuelve tipo, posicion, orden Z, titulo, campos por rol, medidas y columnas referenciadas, si tiene formato propio, sus filtros, y la definicion cruda por si hace falta inspeccionarla.

Version PBIR observada, tema, custom visuals y tipos clonables.

Solo se pueden crear visuales de tipos ya presentes en el informe: se clona una estructura real en vez de inventarla. Esta tool dice cuales hay disponibles antes de intentarlo.

Duplica un visual conservando campos, formato y filtros.

Solo se regenera el identificador, que debe ser unico. La copia se desplaza offset_x/offset_y para que no quede tapando al original. target_page permite copiarlo a otra pagina.

Elimina un visual. Operacion destructiva: requiere confirm=true.

Devuelve la definicion previa, y el journal permite restaurarla.

Cambia el titulo de un visual PRESERVANDO su formato (fuente, color).

Fija el orden Z de los visuales de una pagina.

order: ids de MENOR a MAYOR z; el ultimo queda encima. Los visuales que no menciones se colocan por encima, conservando su orden relativo.

Sustituye una referencia de campo dentro de un visual.

old_ref/new_ref: 'Tabla[Campo]' o '[Medida]'. Trabaja sobre las proyecciones existentes; no crea roles nuevos. Falla si el visual no referencia old_ref, en vez de no hacer nada en silencio.

El destino se valida contra el modelo antes de escribir: si no existe, es ambiguo o es de otro tipo (medida donde va una columna), se rechaza con field_not_found en lugar de inventarlo.

Copia el formato de un visual a otros DEL MISMO TIPO.

Se copia el formato pero no el texto del titulo, que es contenido. Copiar entre tipos distintos se rechaza: la estructura de formato no es intercambiable y Power BI podria rechazar el informe.

Duplica una pagina con todos sus visuales, en una sola transaccion.

Se regeneran los identificadores que deben ser unicos (el de la pagina y el de cada visual) y se conserva todo lo demas.

Elimina una pagina y actualiza el orden y la pagina activa.

Destructiva: requiere confirm=true. Se niega a borrar la ultima pagina del informe, porque un informe sin paginas no abre.

Cambia el nombre visible de una pagina. El id interno no cambia.

Fija el orden de las paginas del informe.

Acepta ids o nombres visibles. Las paginas que no menciones quedan al final, conservando su orden relativo.

Diagnostica la geometria de una pagina (o de todas). Solo lectura.

Detecta solapamientos, visuales fuera del lienzo, tamanos demasiado pequenos, margenes, separaciones inconsistentes, orden Z duplicado o ausente, paginas vacias y paginas saturadas. Cada hallazgo trae su evidencia geometrica.

Alinea varios visuales por un borde.

edge: left | right | top | bottom | center_h | center_v. Determinista: la misma entrada produce siempre la misma salida.

Reparte visuales con separacion uniforme. axis: horizontal|vertical.

Necesita al menos tres visuales: con dos, la separacion ya es la que hay.

Corrige lo corregible de una pagina sin reacomodarla entera.

Mete dentro del lienzo lo que se sale, sube al minimo lo demasiado pequeno y respeta los margenes. NO mueve lo que ya esta bien: es una correccion conservadora. dry_run=true devuelve el plan sin escribir.

Presets de pagina disponibles, con los bloques que compone cada uno.

Un preset describe la INTENCION de la pagina (KPIs arriba, grafico protagonista, detalle abajo). Los campos concretos los eliges tu.

Genera un borrador de spec a partir de un preset y unos campos.

preset: executive | financial | sales | operations | evm | detail. measures: medidas para los KPIs y los graficos. category: columna para el eje de los graficos. El resultado es un spec editable: revisalo y pasalo por pbi_validate_page_spec.

Valida un spec: esquema, referencias contra el modelo y geometria.

Los errores traen su JSON path ($.visuals[2].fields.values[0]) para que se puedan corregir sin adivinar. No escribe nada.

Maqueta HTML del spec con las posiciones FINALES. No escribe al .pbip.

Lo que muestra el preview es exactamente lo que se escribiria: tipos, titulos, campos, tamanos y posiciones salen del mismo compilado que usa la aplicacion.

Compara el spec con una pagina existente antes de aplicarlo.

Dice que visuales se anadirian, cuales sobrarian y cuantos quedan igual. Si la pagina no existe, informa que se creara.

Materializa el spec como una pagina PBIR, en UNA transaccion.

Cuatro desenlaces explicitos: create (no existe), update (existe y el spec cambia algo), no_change (ya coincide) y conflict (el nombre no identifica una sola pagina).

page: id o nombre visible de la pagina a actualizar. Si se omite, se usa el nombre del spec. Al actualizar se CONSERVAN el id de la pagina y el de cada visual que siga representando lo mismo.

sync_mode: merge (por defecto) anade y actualiza pero no borra lo que el spec no menciona; replace ademas elimina los visuales ausentes. El defecto es conservador para que un spec parcial no pueda vaciar una pagina por omision.

dry_run=true devuelve un plan con plan_token y no escribe nada; aplicalo despues con pbi_apply_plan.

Verifica una pagina YA escrita: referencias rotas y geometria.

Se usa despues de aplicar un spec para comprobar que el resultado es valido de verdad, no solo que la escritura no fallo.

Lista las paginas del informe PBIR activo (id, nombre, tamano, nº visuales).

Lista los visuales de una pagina: id, tipo, posicion, campos, titulo.

page: id interno o nombre visible de la pagina.

Genera documentacion Markdown del layout del informe (paginas y visuales).

Crea un visual PBIR en una pagina.

visual_type: card|table|matrix|slicer|barChart|columnChart|lineChart|pieChart. fields: roles logicos -> campos, p.ej. {"category":"Tabla[Col]", "values":["[Medida]"], "legend":"Tabla[Col]"}. position: {x, y, width, height} (z opcional). Clona un visual del mismo tipo como plantilla si existe. Hace backup.

Registra un custom visual de AppSource en el informe (publicCustomVisuals).

Sin argumentos registra "HTML Content" (renderiza HTML/SVG desde una medida DAX). Power BI Desktop lo descarga de AppSource al abrir el informe.

Crea un visual "HTML Content" que renderiza el HTML/SVG devuelto por una medida.

html_measure: medida cuyo resultado es HTML (p.ej. "[HTML Panel EVM]"). Registra el custom visual en el informe si aun no esta. La medida se crea aparte con pbi_create_measure (el HTML se arma en DAX, tipicamente con VARs y CONCATENATEX sobre los datos del modelo).

Mueve/redimensiona un visual existente.

Reorganiza los visuales de una pagina.

layout: grid | dashboard | executive_summary | custom. visual_ids: subconjunto opcional (por defecto todos). custom: mapa visual_id -> {x,y,width,height} para layout 'custom'.

Genera una pagina con visuales propuestos a partir del modelo.

Revisa el modelo, valida los campos sugeridos (no inventa campos), crea la pagina, agrega tarjetas para medidas y un grafico por categoria, y acomoda todo con el layout indicado. Devuelve un resumen de lo creado.

Construye un dashboard completo desde un objetivo, no desde primitivas.

Analiza el modelo, compone el spec segun el preset, calcula el layout, genera preview, aplica en una transaccion y verifica el resultado. dry_run=true (por defecto) se detiene tras el preview.

Pagina de resumen ejecutivo: fila de KPIs y grafico protagonista.

Pagina EVM (Earned Value Management).

Espera medidas del tipo PV, EV, AC, CPI y SPI; si no las reconoce, lo avisa en vez de generar una pagina que no significa nada.

Detecta referencias rotas en los visuales y las repara.

Sin mapping solo diagnostica: adivinar a que campo queria apuntar un visual roto no es una decision que deba tomarse sola. Pasa {"Tabla[Viejo]": "Tabla[Nuevo]"} para repararlas, y el destino se valida contra el modelo antes de escribir.

Normaliza la geometria de TODAS las paginas del informe.

Mete dentro del lienzo lo que se sale, sube al minimo lo demasiado pequeno y respeta margenes. No reacomoda lo que ya cumple. Compara el puntaje de auditoria antes y despues.

Compara el modelo EN VIVO con el TMDL del disco.

Util para saber si hay cambios en memoria sin guardar: lista tablas y medidas que solo estan en un lado, y medidas cuyo DAX difiere.

Checklist de pre-entrega con plan de correccion.

Audita el proyecto, produce un checklist de bloqueantes y propone las correcciones automaticas disponibles. Con dry_run=false las aplica y compara el puntaje antes y despues.

Documentacion tecnica completa en Markdown, guardada en outputs/.

Incluye el modelo (tablas, medidas con su DAX y dependencias), el informe pagina a pagina con los campos de cada visual, y la auditoria con puntaje por dominio.