Skip to content

Commit ecc417a

Browse files
chore: update version to 0.11.9 in README, package.json, package-lock.json, and oclif.manifest.json
1 parent 08c9be4 commit ecc417a

4 files changed

Lines changed: 27 additions & 9 deletions

File tree

README.md

Lines changed: 23 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
> **Last update / Última actualización:** 2026-06-11 — `@nervill/metadelta` 0.11.8
1+
> **Last update / Última actualización:** 2026-06-11 — `@nervill/metadelta` 0.11.9
22
33
# Metadelta Salesforce CLI Plugin
44

@@ -50,7 +50,7 @@ Created by **Nerio Villalobos** (<nervill@gmail.com>).
5050
```bash
5151
sf plugins install github:NerioVillalobos/plugin-metadelta.git
5252
```
53-
Confirm installation with `sf plugins`, which should list `@nervill/metadelta 0.11.8`.
53+
Confirm installation with `sf plugins`, which should list `@nervill/metadelta 0.11.9`.
5454

5555
3. (Optional, for local development) Clone this repository and install dependencies:
5656
```bash
@@ -63,7 +63,7 @@ Created by **Nerio Villalobos** (<nervill@gmail.com>).
6363
npm run build
6464
sf plugins link .
6565
```
66-
Confirm installation with `sf plugins`, which should list `@nervill/metadelta 0.11.8 (link)`.
66+
Confirm installation with `sf plugins`, which should list `@nervill/metadelta 0.11.9 (link)`.
6767

6868
### Usage
6969

@@ -380,6 +380,15 @@ Starts a temporary terminal monitor for Salesforce Core and Vlocity metadata dri
380380
sf metadelta monitor run --org DEV
381381
```
382382

383+
Options:
384+
385+
| Flag | Description | Default |
386+
| --- | --- | --- |
387+
| `--org`, `-o` | Alias or username of the target org. | Required |
388+
| `--interval` | Refresh interval in minutes. Values below `1` are normalized to `1`. | `5` |
389+
| `--scope` | Metadata source to monitor: `all`, `salesforce`, or `vlocity`. | `all` |
390+
| `--once` | Run one refresh cycle and exit after cleanup. Useful for validation. | `false` |
391+
383392
The monitor creates `.metadelta-monitor/`, retrieves the current metadata snapshot, initializes a local-only Git repository as the diff engine, and refreshes every five minutes. `NEXT` shows the exact next refresh time instead of repainting a countdown. The first cycle creates the baseline and shows `STATUS: BASELINE CREATED`; later refreshes show added, modified, deleted, or renamed files. Full errors and Vlocity warnings are wrapped in a detail section and automatically pause UI repainting so the text can be selected/copied.
384393

385394
The UI has two navigable sections. `SALESFORCE CORE / VLOCITY` groups changes by metadata type and shows the count, latest change date, and latest modifier for each type. `RECENT CHANGES` lists the session-cumulative component changes with the most recently detected items first. The arrow keys move the `>` selector across both sections; when the selected row moves past the visible terminal area, the list scrolls so the selector remains visible. Press Enter or `d` on an individual change to see its file, metadata query, modifier, detection time, and Git diff summary. Press Enter or `d` on a metadata type to open `TYPE DETAILS`, which lists the changed components for that type in recent-first order.
@@ -403,7 +412,7 @@ sf metadelta monitor run --org DEV --scope salesforce
403412
> **Linked ESM note:** When `sf` prints `@nervill/metadelta is a linked ESM module and cannot be auto-transpiled`, always run `npm run build` before testing commands. If your CLI still does not resolve `sf metadelta task record`, use `sf metadelta:task:record` and relink the plugin. Task diagnostics are saved in `.metadelta/metadelta-task-orchestrator.json`. This is mandatory after local code changes; otherwise `sf` may run stale compiled `lib/` output.
404413
> **Task play hardening:** `sf metadelta task play` now includes automatic stabilizers for frontdoor/base URL separation, initial Setup popup recovery, popup rebinds, App Launcher fallbacks, dynamic Permission Set Assignment selectors, and Action Library scroll selection + Finish enablement checks in the temporary `.metadelta.*` test file.
405414
> **Salesforce CLI secrets workaround (v0.11.4):** `sf metadelta task record` and `sf metadelta task play` build Salesforce frontdoor URLs from the alias passed in `--org`. When they need the real `accessToken`, Metadelta now runs the required `sf org display --target-org <alias> --verbose --json` calls with `SF_TEMP_SHOW_SECRETS=true` in the child process environment. This keeps the automation compatible with Salesforce CLI outputs that redact secrets, without asking users to run `sf org auth ...` interactively or set the workaround globally.
406-
> **Monitor Vlocity support (v0.11.8):** `sf metadelta monitor run` can monitor Vlocity-only sessions with `--scope vlocity` and uses `vlocity -sfdx.username <orgAlias> -job <temporary-yaml> --projectPath <paths.vlocity> packExportAllDefault`. The temporary YAML sets `continueAfterError: true`.
415+
> **Monitor Vlocity support (v0.11.9):** `sf metadelta monitor run` can monitor Vlocity-only sessions with `--scope vlocity` and uses `vlocity -sfdx.username <orgAlias> -job <temporary-yaml> --projectPath <paths.vlocity> packExportAllDefault`. The temporary YAML sets `continueAfterError: true`.
407416
> **Task orchestrator diagnostics:** The orchestrator now stores the most relevant Playwright failure excerpt (not only the exit code), making solution matching and future triage more accurate in `.metadelta/metadelta-task-orchestrator.json`.
408417
> **Report a task-play issue:** If playback fails, please open a public GitHub Issue at <https://github.com/NerioVillalobos/plugin-metadelta/issues> and include: (1) command executed, (2) full error text, (3) screenshot captured while running with `--header`, and (4) sanitized `.metadelta.*` snippet around the failing step.
409418

@@ -1010,6 +1019,15 @@ Inicia un monitor temporal de terminal para detectar drift de metadatos Salesfor
10101019
sf metadelta monitor run --org DEV
10111020
```
10121021
1022+
Opciones:
1023+
1024+
| Flag | Descripción | Valor por defecto |
1025+
| --- | --- | --- |
1026+
| `--org`, `-o` | Alias o username del org destino. | Requerido |
1027+
| `--interval` | Intervalo de refresh en minutos. Los valores menores a `1` se normalizan a `1`. | `5` |
1028+
| `--scope` | Fuente de metadata a monitorear: `all`, `salesforce` o `vlocity`. | `all` |
1029+
| `--once` | Ejecuta un solo ciclo de refresh y sale después del cleanup. Útil para validación. | `false` |
1030+
10131031
El monitor crea `.metadelta-monitor/`, recupera el snapshot actual de metadatos, inicializa un repositorio Git local como motor de diff y refresca cada cinco minutos. `NEXT` muestra la hora exacta del próximo refresh en vez de repintar un countdown. El primer ciclo crea la línea base y muestra `STATUS: BASELINE CREATED`; los siguientes refresh muestran archivos agregados, modificados, eliminados o renombrados. Los errores completos y avisos de Vlocity se muestran envueltos en una sección de detalle y pausan automáticamente el repintado de la UI para poder seleccionar/copiar el texto.
10141032
10151033
La UI tiene dos secciones navegables. `SALESFORCE CORE / VLOCITY` agrupa cambios por tipo de metadata y muestra contador, fecha del último cambio y último usuario modificador para cada tipo. `RECENT CHANGES` lista los cambios acumulados de la sesión con los elementos detectados más recientemente primero. Las flechas mueven el selector `>` por ambas secciones; cuando la fila seleccionada supera el área visible de la terminal, la lista se desplaza para mantener el selector en pantalla. Presiona Enter o `d` sobre un cambio individual para ver archivo, query de metadata, modificador, hora de detección y resumen del diff Git. Presiona Enter o `d` sobre un tipo de metadata para abrir `TYPE DETAILS`, que lista los componentes cambiados de ese tipo en orden reciente primero.
@@ -1033,7 +1051,7 @@ sf metadelta monitor run --org DEV --scope salesforce
10331051
> **Nota para ESM enlazado:** Si `sf` muestra `@nervill/metadelta is a linked ESM module and cannot be auto-transpiled`, ejecuta `npm run build` antes de probar comandos. Si la CLI no resuelve `sf metadelta task record`, usa `sf metadelta:task:record` y vuelve a enlazar el plugin. El diagnóstico de tareas se guarda en `.metadelta/metadelta-task-orchestrator.json`. Esto es obligatorio tras cambios locales de código; de lo contrario `sf` puede ejecutar un `lib/` compilado desactualizado.
10341052
> **Robustez en task play:** `sf metadelta task play` incluye estabilizadores automáticos para separar frontdoor/base URL, recuperar la apertura inicial del popup de Setup, reabrir popups, aplicar fallback en App Launcher, normalizar selectores dinámicos de Permission Set Assignment y resolver selección con scroll + validación de botón Finish en Action Library dentro del archivo temporal `.metadelta.*`.
10351053
> **Workaround de secretos de Salesforce CLI (v0.11.4):** `sf metadelta task record` y `sf metadelta task play` construyen URLs frontdoor usando el alias recibido en `--org`. Cuando necesitan el `accessToken` real, Metadelta ejecuta las llamadas requeridas a `sf org display --target-org <alias> --verbose --json` con `SF_TEMP_SHOW_SECRETS=true` en el entorno del proceso hijo. Esto mantiene la automatización compatible con salidas de Salesforce CLI que ocultan secretos, sin pedir al usuario ejecutar `sf org auth ...` de forma interactiva ni configurar el workaround globalmente.
1036-
> **Soporte monitor Vlocity (v0.11.8):** `sf metadelta monitor run` puede monitorear sesiones solo Vlocity con `--scope vlocity` y usa `vlocity -sfdx.username <orgAlias> -job <temporary-yaml> --projectPath <paths.vlocity> packExportAllDefault`. El YAML temporal define `continueAfterError: true`.
1054+
> **Soporte monitor Vlocity (v0.11.9):** `sf metadelta monitor run` puede monitorear sesiones solo Vlocity con `--scope vlocity` y usa `vlocity -sfdx.username <orgAlias> -job <temporary-yaml> --projectPath <paths.vlocity> packExportAllDefault`. El YAML temporal define `continueAfterError: true`.
10371055
> **Diagnóstico del orquestador:** El orquestador ahora guarda el fragmento más relevante del fallo de Playwright (no solo el código de salida), mejorando el match de soluciones y el triage futuro dentro de `.metadelta/metadelta-task-orchestrator.json`.
10381056
> **Reportar incidencias de task play:** Si la reproducción falla, abre un Issue público en GitHub: <https://github.com/NerioVillalobos/plugin-metadelta/issues> e incluye: (1) comando ejecutado, (2) texto completo del error, (3) captura ejecutando con `--header`, y (4) fragmento saneado del archivo `.metadelta.*` en el paso donde falla.
10391057

oclif.manifest.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -915,5 +915,5 @@
915915
]
916916
}
917917
},
918-
"version": "0.11.8"
918+
"version": "0.11.9"
919919
}

package-lock.json

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@nervill/metadelta",
3-
"version": "0.11.8",
3+
"version": "0.11.9",
44
"description": "Salesforce CLI plugin to find recent metadata changes in an org",
55
"type": "module",
66
"main": "lib/index.js",

0 commit comments

Comments
 (0)