@roilab/crm-cli 0.23.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -6,6 +6,42 @@ Todos los cambios notables se documentan aquí. El formato sigue
6
6
 
7
7
  ## [Sin publicar]
8
8
 
9
+ ## [0.24.0] — 2026-11-13
10
+
11
+ ### Fixed
12
+
13
+ - **Ventas de una categoría.** Solo sumaban las fichas que la tenían como
14
+ categoría por defecto, así que categorías como "semillas feminizadas
15
+ exterior", cuyas fichas cuelgan por defecto de otras, salían sin ventas.
16
+ Ahora suman todas las fichas asociadas a la categoría o a sus subcategorías,
17
+ como las lista la tienda, cada una una vez (también en `--top --category` y
18
+ en la revisión de métricas). El puesto de una ficha sigue siendo dentro de su
19
+ categoría por defecto.
20
+ - **Interanual de ventas a medias.** `crm site sales` daba el interanual de 90
21
+ días aunque la tienda no tuviera cargado el año pasado entero (la carga
22
+ inicial era de 400 días y hacen falta 454). Ahora carga 460, las tiendas ya
23
+ cargadas amplían solas su histórico y, si falta parte del año pasado,
24
+ `previousYear.complete` es `false` y el porcentaje sale `null`.
25
+
26
+ ### Added
27
+
28
+ - **Redirecciones 301 del blog: `crm site redirect list | create | delete`.**
29
+ Sin plugin de redirecciones ni `.htaccess`, con el mu-plugin
30
+ `roilab-seo-rest` 1.2.0. Post → post es una fusión (el origen a la papelera
31
+ y WordPress responde 301 por su slug antiguo); lo demás va por ruta y el
32
+ origen publicado pasa a la papelera. Comprueba antes que el destino da 200 y
33
+ se indexa, enseña los clics del origen y sus versiones en otros idiomas, y
34
+ después comprueba el 301 y lo registra en la tarea. `--dry-run` para ver el
35
+ plan.
36
+ - **Accesos: `crm credential list | request | fetch`.** Los usuarios y
37
+ contraseñas de las plataformas de un cliente viven cifrados en el CRM y las
38
+ tareas los enlazan. `list` da nombre, URL y usuario, nunca la contraseña.
39
+ `create` guarda uno nuevo (la contraseña por stdin o fichero, nunca como
40
+ argumento) y `link` lo enlaza a una tarea. `request` la pide: la persona dueña de la clave la aprueba en el CRM (solo
41
+ si ella tiene acceso) y el agente la puede leer 15 minutos con `fetch` o
42
+ directamente con `request --wait`. Scopes nuevos `credentials:read`,
43
+ `credentials:write` y `credentials:reveal`; las claves de API ya emitidas no los tienen.
44
+
9
45
  ## [0.23.0] — 2026-11-11
10
46
 
11
47
  ### Added
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 ROILab Intelligence
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 ROILab Intelligence
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -111,8 +111,8 @@ crm site sales --top 50 --connection <id> # ranking de fichas por
111
111
  crm site sales --top 20 --category 598 --days 28 --connection <id>
112
112
  ```
113
113
 
114
- Una categoría suma sus fichas por categoría por defecto, incluidas las de sus
115
- subcategorías. El interanual compara con las mismas fechas de hace 52 semanas.
114
+ Una categoría suma todas las fichas asociadas a ella o a sus subcategorías,
115
+ como las lista la tienda, no solo las que la tienen por defecto. El interanual compara con las mismas fechas de hace 52 semanas.
116
116
  La revisión de métricas de una tarea añade las ventas de sus fichas y
117
117
  categorías antes y después.
118
118
 
package/SKILL.md CHANGED
@@ -232,7 +232,27 @@ Reglas:
232
232
  - **Cuándo NO usar noindex:** para arreglar una canibalización (se arregla con contenido y enlaces), en una página con clics que la tarea no dice expresamente que hay que quitar, ni "por si acaso". Sí: páginas vacías, duplicadas o de servicio que no deben salir, y siempre porque lo pide la tarea.
233
233
  - **Canonical:** URL absoluta del mismo dominio que responda 200 sin redirigir y no tenga noindex; si no, se bloquea. Un canonical a la propia página equivale al automático. No mezcles noindex y canonical a otra URL en la misma página (se avisa).
234
234
  - Volver a `index` o `default` no pide permiso: la página tarda en volver a Google; puedes pedir la indexación en Search Console.
235
- - **Fuera de alcance:** URL/slug (exige redirección), precios, stock, borrar. Eso va por tarea a quien corresponda.
235
+ - **Fuera de alcance:** cambiar la URL/slug, precios, stock, borrar. Eso va por tarea a quien corresponda. Las redirecciones 301 del blog sí se hacen desde aquí (abajo).
236
+
237
+ #### Redirecciones 301 del blog (`crm site redirect`)
238
+
239
+ Para fusionar dos posts, quitar uno que sobra o recolocar una URL del blog (WordPress). Sin plugin de redirecciones y sin tocar el `.htaccess`: lo hace el mu-plugin `roilab-seo-rest` 1.2 del blog. Si el blog no lo tiene, el comando lo dice y no hace nada. La tienda (PrestaShop) sigue por `.htaccess`, fuera del CRM.
240
+
241
+ ```bash
242
+ crm site redirect list --url <url-origen> # ¿ya redirige? ¿qué responde ahora?
243
+ crm site redirect create --task <taskId> --from <url-origen> --to <url-destino> --dry-run # plan, clics del origen y versiones en otros idiomas
244
+ # … enseñas el plan y esperas el OK explícito …
245
+ crm site redirect create --task <taskId> --from <url-origen> --to <url-destino> --note "por qué"
246
+ ```
247
+
248
+ - **Cómo lo hace.** Post publicado → post publicado es una **fusión**: el origen va a la papelera y su slug pasa a ser un slug antiguo del destino, así que el 301 lo da el propio WordPress (y sigue funcionando aunque se quite el mu-plugin). Lo demás (páginas, categorías, URLs que ya dan 404) va **por ruta**, en la lista del mu-plugin, y si el origen era un post o una página publicada pasa a la papelera para que salga del sitemap. En los dos casos se vacía la caché de la URL.
249
+ - **Antes de redirigir, el contenido.** Una fusión es pasar al destino lo que el origen tenía de útil (con `crm site update` en el destino) y luego redirigir. Primero el contenido, luego la 301, el mismo día.
250
+ - **Destino:** URL final del mismo dominio que responde 200, sin redirigir y sin noindex. Si no, se bloquea. Nada de cadenas: si el destino ya redirige, apunta a la URL final.
251
+ - **Mira `searchConsole` del `--dry-run`:** son los clics del origen de 90 días. Una URL con clics solo se redirige si la tarea lo pide y a la página que mejor responde a esas búsquedas, nunca a la portada ni a una categoría genérica "por si acaso".
252
+ - **Idiomas (WPML).** En los blogs con un dominio por idioma (los de GB: gbthegreenbrand.com, .fr, .it, .pt y .de), cada traducción es otra URL. El `--dry-run` lista en `translations` las versiones del origen en otros idiomas y su pareja en el destino. Cada una se redirige con su propio `create` y una tarea de ese dominio. Si el destino no tiene versión en ese idioma (`to: null`), no la redirijas a ciegas: dilo en la tarea.
253
+ - **Lee la respuesta:** `applied` y `liveCheck` (`ok` = el origen ya responde 301 al destino). Si no sale `ok`, repite `crm site redirect list --url <origen>` en unos minutos y, si sigue igual, dilo en la tarea. El registro de cambios y el seguimiento del destino se crean solos.
254
+ - **Deshacer:** `crm site redirect delete --task <taskId> --from <url-origen>`. Una fusión vuelve con el post de origen como borrador (hay que publicarlo a mano si se quiere recuperar); una ruta sale de la lista.
255
+ - **No uses 301 para** arreglar una canibalización sin fusionar el contenido, ni para quitar de Google algo que debe seguir existiendo (eso es noindex), ni para cambiar el slug de un post vivo (eso va por tarea a quien publica).
236
256
  - **PrestaShop multitienda:** escribe en la tienda y el idioma de la conexión y conserva los demás idiomas. PrestaShop guarda el objeto entero y su filtro de HTML puede reescribir textos de otros idiomas (igual que desde el back office): sale en `warnings`.
237
257
  - **Sin ráfagas.** Una página detrás de otra; hay servidores que bloquean la IP ante muchas peticiones seguidas.
238
258
  - **URL que no se reconoce** (rutas propias de un módulo): usa `--ref product:<id>` / `category:<id>` / `cms:<id>` / `post:<id>` / `page:<id>` junto a `--url`.
@@ -249,8 +269,9 @@ Antes de proponer un cambio, mira qué dicen los datos de esa página. Tres fuen
249
269
 
250
270
  **Ventas (`crm site sales`).** Las suma el CRM cada noche desde el webservice de la tienda, sin datos de clientes:
251
271
  - Pedidos válidos y no cancelados de la tienda e idioma de la conexión, sin IVA y antes de cupones de carrito. Unidades sin restar devoluciones.
252
- - De una ficha: 28 y 90 días (hasta ayer) con su interanual (mismas fechas de hace 52 semanas) y su puesto por facturación dentro de su categoría. De una categoría: la suma de sus fichas por categoría por defecto, incluidas sus subcategorías, y sus 10 fichas que más facturan. `crm site get` de una ficha o categoría ya trae el resumen de 90 días en `sales`.
272
+ - De una ficha: 28 y 90 días (hasta ayer) con su interanual (mismas fechas de hace 52 semanas) y su puesto por facturación dentro de su categoría por defecto. De una categoría: la suma de todas las fichas asociadas a ella o a sus subcategorías, como las lista la tienda (no solo las que la tienen por defecto; cada ficha cuenta una vez), y sus 10 fichas que más facturan. `crm site get` de una ficha o categoría ya trae el resumen de 90 días en `sales`.
253
273
  - En sumas de varias fichas, `orders` cuenta pedidos por ficha; la facturación y las unidades son exactas.
274
+ - Si `previousYear.complete` es `false`, la tienda no tiene cargado el año pasado entero para esa ventana y el interanual sale `null`: no lo calcules a mano con datos a medias.
254
275
  - **Nunca decidas con el stock** (en algunas tiendas no es real) ni con la facturación de Analytics. Para dinero, la tienda.
255
276
  - Úsalas para priorizar (qué fichas o categorías trabajar primero), para elegir el destino de un enlace cuando dos páginas compiten y para medir: la revisión de métricas de la tarea añade las ventas de sus fichas y categorías antes y después, con el interanual.
256
277
  - Si `available: false`, la tienda no da permiso de lectura de pedidos o aún no se han cargado: dilo en la tarea y sigue con Search Console.
@@ -276,6 +297,28 @@ crm task tracking set <taskId> --no-auto-verify # programarla a mano
276
297
 
277
298
  Las listas van como un solo filtro (GSC combina filtros con AND: diez `equals` darían cero). Las URLs se guardan con y sin barra final para que casen con cómo las tenga Search Console.
278
299
 
300
+ ## Accesos: usuarios y contraseñas (`crm credential`)
301
+
302
+ Las contraseñas de las plataformas de un cliente (Publisuites, un Medium, un panel…) viven cifradas en el CRM, en los accesos del cliente, y las tareas que las necesitan las enlazan. **Nunca las pegues en comentarios, descripciones ni ficheros.**
303
+
304
+ `crm credential list` te da nombre, URL de acceso y usuario, nunca la contraseña. Para usarla, **pídela siempre antes**: la persona dueña de tu clave recibe un aviso en el CRM y la aprueba o rechaza. Solo puede aprobarla si ella misma tiene acceso a esa contraseña. Aprobada, la puedes leer durante 15 minutos y cada lectura queda registrada.
305
+
306
+ ```bash
307
+ crm credential list --task <taskId> # accesos enlazados a la tarea
308
+ crm credential request <id> --task <taskId> --reason "Publicar el enlace de noviembre en Medium" --wait
309
+ # → espera la aprobación y devuelve username + password + loginUrl
310
+ crm credential fetch <requestId> # si no usaste --wait
311
+ ```
312
+
313
+ Si creas una cuenta en una plataforma (o encuentras una contraseña pegada en un comentario), guárdala como acceso. La contraseña entra por stdin, nunca como argumento:
314
+
315
+ ```bash
316
+ printf '%s' "$PASS" | crm credential create --task <taskId> --label "Medium GB" --url medium.com/m/signin --username seo@cliente.com --password-stdin
317
+ crm credential link <id> --task <otraTarea>
318
+ ```
319
+
320
+ Explica el motivo en `--reason` (lo lee quien aprueba). Si la rechazan, no insistas: pregunta. Usa la contraseña solo para esa tarea y no la guardes en ningún sitio.
321
+
279
322
  ## Revisión de métricas (rutina diaria)
280
323
 
281
324
  Una tarea SEO se **aplica** (se completa, `completedAt` = día del cambio) y se **revisa** N días después. Ese día el servidor: