@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 +9 -0
- package/README.md +4 -0
- package/SKILL.md +9 -0
- package/package.json +58 -58
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.
|
|
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
|
+
}
|