@roilab/crm-cli 0.21.0 → 0.21.1

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,15 @@ Todos los cambios notables se documentan aquí. El formato sigue
6
6
 
7
7
  ## [Sin publicar]
8
8
 
9
+ ## [0.21.1] — 2026-11-09
10
+
11
+ ### Docs
12
+
13
+ - **Norma de OK explícito en la guía para agentes (`SKILL.md`).** Antes de
14
+ cualquier cambio en una web, el agente enseña el `--dry-run` a la persona,
15
+ espera un "sí, publica" y, después de aplicar, deja la decisión en un
16
+ comentario `--kind decision` de la tarea. El encargo inicial no cuenta como OK.
17
+
9
18
  ## [0.21.0] — 2026-11-09
10
19
 
11
20
  ### Added
package/README.md CHANGED
@@ -82,6 +82,10 @@ crm site update --task tsk_abc --url https://www.tienda.com/598-cbd \
82
82
  --meta-title-file title.txt --meta-desc-file desc.txt --note "por qué"
83
83
  ```
84
84
 
85
+ Norma de trabajo: ningún cambio se aplica sin el OK explícito de la persona que
86
+ hace la tarea. El agente enseña el `--dry-run`, espera un "sí, publica", aplica y
87
+ deja la decisión en un comentario de la tarea (`--kind decision`).
88
+
85
89
  `update` escribe solo lo que cambia, vuelve a leer la página para confirmar lo
86
90
  guardado, comprueba la página publicada y registra el cambio con el antes y el
87
91
  después reales. No escribe si no has leído en las últimas 24 horas la versión
package/SKILL.md CHANGED
@@ -87,6 +87,12 @@ Errors **always** appear on stderr with full envelope, bypassing `--jq`. Exit co
87
87
 
88
88
  ## Work as an agent, not a human
89
89
 
90
+ 0. **OK explícito de la persona antes de cualquier cambio (OBLIGATORIO).** Cambiar una web (`crm site update` sin `--dry-run`), o cualquier cosa que se vea fuera del CRM, solo después de que la persona para la que trabajas lo apruebe expresamente:
91
+ 1. Prepara el cambio y enséñale el resultado de `--dry-run`: cada campo con el antes y el después.
92
+ 2. Espera un "sí, publica" claro. "Hazlo con ajustes", "vale" a otra pregunta o el silencio no valen: si hay ajustes, rehaz el borrador y vuelve a enseñarlo.
93
+ 3. Aplica y deja la decisión en un comentario de la tarea: `crm comment create --task <id> --kind decision --body-file decision.md` (qué se aprobó, quién y cuándo).
94
+ El encargo inicial ("haz esta tarea") no es el OK de los cambios concretos. Solo te lo puedes saltar si la persona te dice expresamente, para esa tarea, que apliques sin preguntar.
95
+
90
96
  1. **Preflight ritual antes de `task create` (OBLIGATORIO)**. Una sola llamada antes de cualquier creación de tarea — el server hace fan-out por ti:
91
97
 
92
98
  ```bash
@@ -207,10 +213,13 @@ crm recall <url> # trabajo previo sobre l
207
213
  crm site get --url <url> --quiet > actual.json # valores de AHORA (h1, metaTitle, metaDescription, content, summary)
208
214
  # … preparas los textos nuevos en ficheros UTF-8 …
209
215
  crm site update --task <taskId> --url <url> --meta-title-file t.txt --meta-desc-file d.txt --dry-run # diff
216
+ # … enseñas el diff a la persona y esperas su OK explícito ("sí, publica") …
210
217
  crm site update --task <taskId> --url <url> --meta-title-file t.txt --meta-desc-file d.txt --note "por qué"
218
+ crm comment create --task <taskId> --kind decision --body-file decision.md # qué se aprobó, quién y cuándo
211
219
  ```
212
220
 
213
221
  Reglas:
222
+ - **OK explícito antes de aplicar** (regla 0 de "Work as an agent"): enseña el `--dry-run` y no lances el `update` real hasta tener un "sí, publica" de la persona. Después, comentario `--kind decision` en la tarea.
214
223
  - **`--task` siempre**, y la tarea tiene que ser del mismo dominio que la web. Sin tarea no se escribe.
215
224
  - **Lee antes de escribir** (`crm site get`) y parte de ese texto para el contenido: `--content-file` sustituye el HTML entero.
216
225
  - **Lee la respuesta:** `applied` (lo que la relectura confirma), `notApplied` (lo que la web no guardó; ej. un plugin que corta el guardado), `liveCheck` (`ok`, `cached` = la caché aún sirve lo viejo, `mismatch`, `unverifiable` = la página no responde 200) y `warnings`. Si hay `notApplied` o `mismatch`, dilo en la tarea; no lo des por hecho.
package/package.json CHANGED
@@ -1,58 +1,58 @@
1
- {
2
- "name": "@roilab/crm-cli",
3
- "version": "0.21.0",
4
- "description": "CLI for humans and AI agents to drive the ROILab SEO+CRM platform. Always-JSON envelope, numeric exit codes, idempotent writes, device-flow auth.",
5
- "type": "module",
6
- "bin": {
7
- "crm": "./dist/bin/crm.js"
8
- },
9
- "files": [
10
- "dist",
11
- "skill-bundles",
12
- "SKILL.md",
13
- "SURFACE.txt",
14
- "README.md",
15
- "LICENSE",
16
- "CHANGELOG.md"
17
- ],
18
- "scripts": {
19
- "build": "tsc -p tsconfig.json",
20
- "typecheck": "tsc -p tsconfig.json --noEmit",
21
- "test": "node --test __tests__/*.test.mjs",
22
- "pack:check": "npm pack --dry-run",
23
- "prepublishOnly": "npm run build && npm run typecheck && npm run test"
24
- },
25
- "keywords": [
26
- "seo",
27
- "crm",
28
- "cli",
29
- "ai-agent",
30
- "claude",
31
- "mcp",
32
- "roilab"
33
- ],
34
- "author": "ROILab Intelligence <info@roilab.es>",
35
- "license": "MIT",
36
- "homepage": "https://github.com/RoilabIntelligence/crm/tree/main/cli#readme",
37
- "repository": {
38
- "type": "git",
39
- "url": "git+https://github.com/RoilabIntelligence/crm.git",
40
- "directory": "cli"
41
- },
42
- "bugs": {
43
- "url": "https://github.com/RoilabIntelligence/crm/issues"
44
- },
45
- "publishConfig": {
46
- "access": "public"
47
- },
48
- "dependencies": {
49
- "commander": "^12.1.0"
50
- },
51
- "devDependencies": {
52
- "@types/node": "^20.14.0",
53
- "typescript": "^5.5.0"
54
- },
55
- "engines": {
56
- "node": ">=20"
57
- }
58
- }
1
+ {
2
+ "name": "@roilab/crm-cli",
3
+ "version": "0.21.1",
4
+ "description": "CLI for humans and AI agents to drive the ROILab SEO+CRM platform. Always-JSON envelope, numeric exit codes, idempotent writes, device-flow auth.",
5
+ "type": "module",
6
+ "bin": {
7
+ "crm": "./dist/bin/crm.js"
8
+ },
9
+ "files": [
10
+ "dist",
11
+ "skill-bundles",
12
+ "SKILL.md",
13
+ "SURFACE.txt",
14
+ "README.md",
15
+ "LICENSE",
16
+ "CHANGELOG.md"
17
+ ],
18
+ "scripts": {
19
+ "build": "tsc -p tsconfig.json",
20
+ "typecheck": "tsc -p tsconfig.json --noEmit",
21
+ "test": "node --test __tests__/*.test.mjs",
22
+ "pack:check": "npm pack --dry-run",
23
+ "prepublishOnly": "npm run build && npm run typecheck && npm run test"
24
+ },
25
+ "keywords": [
26
+ "seo",
27
+ "crm",
28
+ "cli",
29
+ "ai-agent",
30
+ "claude",
31
+ "mcp",
32
+ "roilab"
33
+ ],
34
+ "author": "ROILab Intelligence <info@roilab.es>",
35
+ "license": "MIT",
36
+ "homepage": "https://github.com/RoilabIntelligence/crm/tree/main/cli#readme",
37
+ "repository": {
38
+ "type": "git",
39
+ "url": "git+https://github.com/RoilabIntelligence/crm.git",
40
+ "directory": "cli"
41
+ },
42
+ "bugs": {
43
+ "url": "https://github.com/RoilabIntelligence/crm/issues"
44
+ },
45
+ "publishConfig": {
46
+ "access": "public"
47
+ },
48
+ "dependencies": {
49
+ "commander": "^12.1.0"
50
+ },
51
+ "devDependencies": {
52
+ "@types/node": "^20.14.0",
53
+ "typescript": "^5.5.0"
54
+ },
55
+ "engines": {
56
+ "node": ">=20"
57
+ }
58
+ }