@roilab/crm-cli 0.4.0 → 0.6.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 +195 -144
- package/SURFACE.txt +237 -214
- package/dist/bin/crm.js +2 -0
- package/dist/bin/crm.js.map +1 -1
- package/dist/src/commands/chat.js +17 -0
- package/dist/src/commands/chat.js.map +1 -1
- package/dist/src/commands/rank.js +300 -0
- package/dist/src/commands/rank.js.map +1 -0
- package/dist/src/commands/skill.js +169 -0
- package/dist/src/commands/skill.js.map +1 -1
- package/package.json +58 -58
package/CHANGELOG.md
CHANGED
|
@@ -1,144 +1,195 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
Todos los cambios notables se documentan aquí. El formato sigue
|
|
4
|
-
[Keep a Changelog](https://keepachangelog.com/es/) y el versionado es
|
|
5
|
-
[SemVer](https://semver.org/lang/es/).
|
|
6
|
-
|
|
7
|
-
## [Unreleased]
|
|
8
|
-
|
|
9
|
-
_Ningún cambio pendiente todavía._
|
|
10
|
-
|
|
11
|
-
## [0.
|
|
12
|
-
|
|
13
|
-
### Added
|
|
14
|
-
|
|
15
|
-
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
`
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
- **`
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
- **`crm
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
`--
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
-
|
|
82
|
-
|
|
83
|
-
`crm
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
-
|
|
134
|
-
`
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
Todos los cambios notables se documentan aquí. El formato sigue
|
|
4
|
+
[Keep a Changelog](https://keepachangelog.com/es/) y el versionado es
|
|
5
|
+
[SemVer](https://semver.org/lang/es/).
|
|
6
|
+
|
|
7
|
+
## [Unreleased]
|
|
8
|
+
|
|
9
|
+
_Ningún cambio pendiente todavía._
|
|
10
|
+
|
|
11
|
+
## [0.6.0] — 2026-05-18
|
|
12
|
+
|
|
13
|
+
### Added
|
|
14
|
+
|
|
15
|
+
- **`crm chat get <threadId> [--message-limit n]`.** Devuelve el hilo
|
|
16
|
+
completo (metadata + participantes + `unreadCount` + últimos mensajes)
|
|
17
|
+
en una sola llamada. Mapea a `GET /chats/:id`. Cierra el hueco entre
|
|
18
|
+
`chat list` (sólo metadata) y `chat read` (sólo mensajes paginados).
|
|
19
|
+
- **`crm skill {revisions,revision,create,set,archive,restore}`.** Cierra
|
|
20
|
+
la superficie de gestión de skills en Convex:
|
|
21
|
+
- `skill revisions <slug>` → historial publicado (`GET /skills/:slug/revisions`).
|
|
22
|
+
- `skill revision <id>` → revisión inmutable completa
|
|
23
|
+
(`GET /skills/revisions/:id`).
|
|
24
|
+
- `skill create --slug --name --description --category [--kind --tag
|
|
25
|
+
--visibility --body --frontmatter]` → crea draft
|
|
26
|
+
(`POST /skills`). La primera publicación va con `skill push <slug>
|
|
27
|
+
--publish`.
|
|
28
|
+
- `skill set <slug> [--name --description --category --kind --tag
|
|
29
|
+
--visibility]` → patch de metadatos
|
|
30
|
+
(`PATCH /skills/:slug`). El cuerpo y frontmatter se editan con
|
|
31
|
+
`skill push` — `set` cubre sólo los campos del registro.
|
|
32
|
+
- `skill archive <slug>` / `skill restore <slug>` → ocultar / restaurar
|
|
33
|
+
(`POST /skills/:slug/archive` y `/restore`).
|
|
34
|
+
|
|
35
|
+
### Fixed
|
|
36
|
+
|
|
37
|
+
- **`task create --no-review` ahora aplica el flag.** Antes el CLI lo
|
|
38
|
+
enviaba pero el schema Zod de `create_task` no lo declaraba, así que
|
|
39
|
+
Zod lo descartaba antes de llegar a `apiGateway.createTask`. Añadido
|
|
40
|
+
`reviewRequired` al schema y a `GATEWAY_ONLY_FIELDS` para que la ruta
|
|
41
|
+
de cookies Better-Auth siga limpiando el campo (la mutación directa
|
|
42
|
+
`api.tasks.create` no lo acepta — `actorType` decide el valor server-
|
|
43
|
+
side para callers no-agente).
|
|
44
|
+
|
|
45
|
+
## [0.5.0] — 2026-05-17
|
|
46
|
+
|
|
47
|
+
### Added
|
|
48
|
+
|
|
49
|
+
- **`crm rank {list,get,add,tag,archive,restore,delete}`.** CLI completo
|
|
50
|
+
para keywords del rank tracker. Reads cubren filtros `--domain` /
|
|
51
|
+
`--country` / `--device` / `--state` / `--unranked` / `--canibalised`
|
|
52
|
+
/ `--search`; `--ids-only` deja pipear a las operaciones bulk.
|
|
53
|
+
Writes: `add` importa keywords desde `--text` / `--file` / `--stdin`;
|
|
54
|
+
`tag` acepta `--add` / `--remove` / `--replace`; `archive`,
|
|
55
|
+
`restore` y `delete` operan en lotes hasta 500 ids. Todos los bulk
|
|
56
|
+
aceptan ids posicionales, `--stdin` (newline / coma / espacio) o
|
|
57
|
+
`--ids-from-file`. Endpoints REST equivalentes:
|
|
58
|
+
`/api/v1/rank-tracker/keywords*`. Requiere los scopes
|
|
59
|
+
`rank-tracker:read` / `rank-tracker:write` (concedidos por defecto
|
|
60
|
+
a owner / admin / member; nunca a roles cliente).
|
|
61
|
+
|
|
62
|
+
## [0.4.0] — 2026-05-12
|
|
63
|
+
|
|
64
|
+
### Added
|
|
65
|
+
|
|
66
|
+
- **Task participants completos.** `task create` y `task update` aceptan
|
|
67
|
+
`--collaborator <id...>` (followers — notificados pero no responsables) además
|
|
68
|
+
de `--assignee`. También cierra otros huecos del registro REST que el CLI no
|
|
69
|
+
exponía: `--start <date>`, `--completion-strategy <all|any|manual>`,
|
|
70
|
+
`--board <id>` (mover de tablero en `update`), y `--tag <id...>` /
|
|
71
|
+
`--assignee <id...>` en `update`. Equivalente Convex: el campo
|
|
72
|
+
`tasks.collaborators` ya existía pero no estaba enrutado por el gateway ni
|
|
73
|
+
el endpoint REST — ahora sí.
|
|
74
|
+
- **`crm backlink {pending,verify,reject,rejection-report}`.** Cubre el flujo
|
|
75
|
+
humano de QA de backlinks. `reject` requiere `--reason` estructurado del
|
|
76
|
+
catálogo (`spammy_source | wrong_anchor | wrong_target | nofollow_unexpected
|
|
77
|
+
| dead_on_arrival | duplicate | policy_violation | other`).
|
|
78
|
+
- **`crm review feedback [--retryable-only]`.** Loop de iteración del agente
|
|
79
|
+
documentado en `SKILL.md`: lee tus propuestas rechazadas con `rejectionReason`
|
|
80
|
+
+ `allowRetry` para re-proponer. Mapea a `GET /reviews/feedback`.
|
|
81
|
+
- **`crm review bulk-approve` / `bulk-reject`.** Aprueba o rechaza hasta 100
|
|
82
|
+
propuestas en una sola llamada. Items por stdin (NDJSON o tokens `kind:id`),
|
|
83
|
+
típico encadenado: `crm review list --jq '.data[] | "\(.kind):\(.id)"' | crm
|
|
84
|
+
review bulk-approve`.
|
|
85
|
+
- **`crm report {create,update,delete}`.** Schedules CRUD. Body JSON por
|
|
86
|
+
`--body <json | @path | ->` para no aplanar la unión scope/cadence/approval
|
|
87
|
+
en flags mutuamente dependientes.
|
|
88
|
+
- **`crm access {request,list,approve,deny}`.** Namespace canónico para
|
|
89
|
+
solicitudes de acceso vía chat. Las variantes antiguas bajo `crm task
|
|
90
|
+
{request-access,list-access-requests,approve-access,deny-access}` siguen
|
|
91
|
+
funcionando con un aviso `[DEPRECATED]` en stderr; se retiran en la
|
|
92
|
+
próxima release mayor.
|
|
93
|
+
- **`crm commands`.** Dump JSON del árbol completo del CLI (verbos, args,
|
|
94
|
+
flags) para que los agentes introspeccionen la superficie sin parsear
|
|
95
|
+
`--help`. Devuelve `{ data: { tree, flat } }`.
|
|
96
|
+
- **`crm dashboard summary --start --end`.** Time-series agregado de todo el
|
|
97
|
+
workspace para overviews. Mapea a `GET /dashboard/summary`.
|
|
98
|
+
- **`crm domain get <id>`.** Single-domain fetch con tags + propiedades
|
|
99
|
+
resueltas. Nuevo endpoint `GET /domains/:id` en el registro REST.
|
|
100
|
+
- **`crm time list-task <taskId>`.** Lista entradas de tiempo de una tarea
|
|
101
|
+
sin filtro por fecha. Mapea a `GET /tasks/:taskId/time-entries`.
|
|
102
|
+
|
|
103
|
+
### Changed
|
|
104
|
+
|
|
105
|
+
- **`task update --client-visible` ahora es simétrico.** Antes era
|
|
106
|
+
`--client-visible <bool>` (string parseado). Ahora se usan los flags
|
|
107
|
+
booleanos de commander: `--client-visible` para marcar visible,
|
|
108
|
+
`--no-client-visible` para marcar interna. Omitir el flag deja la
|
|
109
|
+
visibilidad sin cambios. `task create --client-visible` ya era el flag
|
|
110
|
+
booleano correcto.
|
|
111
|
+
- **Notificación de actualización a usuarios — dos canales nuevos:**
|
|
112
|
+
- **Cache auto-refresh en segundo plano.** Al ejecutar cualquier comando
|
|
113
|
+
el CLI lanza un hijo *detached* (no bloquea el foreground) que
|
|
114
|
+
refresca `~/.config/crm/cache.json` contra `registry.npmjs.org` cuando
|
|
115
|
+
está caducada (>24h) o no existe. Antes solo `crm doctor` refrescaba;
|
|
116
|
+
ahora cualquier invocación cierra el hueco "nunca corro doctor". El
|
|
117
|
+
nudge instantáneo (`maybeNudgeFromCache`) sigue siendo síncrono y sin
|
|
118
|
+
red — el hijo solo escribe la cache para la siguiente invocación.
|
|
119
|
+
- **`User-Agent` + `X-Crm-Cli-Version` en cada llamada HTTP.** El
|
|
120
|
+
servidor compara contra `RECOMMENDED_CLI_VERSION` y `MIN_CLI_VERSION`
|
|
121
|
+
en `src/lib/cli-version-policy.ts`. Si el caller va por detrás, estampa
|
|
122
|
+
`meta.cliUpdate: { current, recommended, severity }` en cada envelope
|
|
123
|
+
(tanto éxito como error, también en replays idempotentes). El CLI lee
|
|
124
|
+
`meta.cliUpdate` y muestra un aviso por stderr una vez por proceso —
|
|
125
|
+
"soft" para upgrades recomendados, "ATENCIÓN" para versiones por
|
|
126
|
+
debajo del mínimo. Mecanismo controlado para forzar avisos sin esperar
|
|
127
|
+
a la TTL de cache de 24h.
|
|
128
|
+
|
|
129
|
+
## [0.3.0] — 2026-05-04
|
|
130
|
+
|
|
131
|
+
### Added
|
|
132
|
+
- `crm task preflight --title <t> [--url <u>] [--domain <id>]` — bundle de
|
|
133
|
+
un round-trip que un agente debe ejecutar **antes** de cualquier
|
|
134
|
+
`crm task create`. Devuelve seis secciones acotadas (≤5 items por
|
|
135
|
+
defecto): `similarTasks` (FTS de título re-rankeado por Jaccard +
|
|
136
|
+
recencia + bonus same-domain), `recall` (cuando pasas `--url` —
|
|
137
|
+
fan-out por URL como en `crm recall`, capeado a 10), `recentChanges`,
|
|
138
|
+
`urlScopedTasks` (tareas abiertas ya enlazadas a esa URL),
|
|
139
|
+
`recentBacklinks`, `openTaskCounts` del dominio y `hints[]` en
|
|
140
|
+
español. El `summary` del envelope prioriza la pista accionable
|
|
141
|
+
(duplicado → cargas en URL → similares → adelante).
|
|
142
|
+
Equivalente REST: `GET /tasks/preflight?title=…&url=…&domainId=…`.
|
|
143
|
+
- Skill bundle nuevo `task-preflight` (lazy) con árbol de decisión:
|
|
144
|
+
cuándo NO crear, cuándo cargar GSC/GA4 vivo después del preflight,
|
|
145
|
+
anti-patrones, ejemplo realista. Cárgalo sólo si el envelope deja
|
|
146
|
+
al agente en duda — el `summary` resuelve el 80% de los casos.
|
|
147
|
+
|
|
148
|
+
### Changed
|
|
149
|
+
- `cli/SKILL.md` — la regla operativa #1 pasa de "always recall before
|
|
150
|
+
creating" a el **ritual obligatorio del preflight**. Documenta que no
|
|
151
|
+
hay que pre-crawlear con Screaming Frog para entender una URL puntual
|
|
152
|
+
(usa `WebFetch` 1-shot) y que GSC/GA4 vivos se llaman *después* del
|
|
153
|
+
preflight, no antes.
|
|
154
|
+
- `tool-routing` añade fila para "decidir si crear tarea" → apunta a
|
|
155
|
+
`task-preflight` antes de cargar cualquier otro skill.
|
|
156
|
+
|
|
157
|
+
## [0.2.0] — 2026-05-01
|
|
158
|
+
|
|
159
|
+
### Added
|
|
160
|
+
- `crm task list --review-pending` y `--review-acked` para filtrar tareas
|
|
161
|
+
según `reviewRequired`. Útil para que un agente encuentre rápidamente las
|
|
162
|
+
tareas que él mismo creó y siguen pendientes de validación humana.
|
|
163
|
+
Equivalente REST: `GET /tasks?reviewRequired=true|false`.
|
|
164
|
+
- Banner `⚠ REVISAR` en el formato `--markdown`/`--styled`: cuando una fila
|
|
165
|
+
individual tiene `reviewRequired: true` la salida se prefija con un aviso
|
|
166
|
+
recordando que la tarea es tentativa hasta que un humano la valide; en
|
|
167
|
+
listados, cada fila pendiente se anota inline y el footer cuenta cuántas
|
|
168
|
+
hay pendientes.
|
|
169
|
+
|
|
170
|
+
### Changed
|
|
171
|
+
- Las descripciones de `list_tasks` y `get_task` (visibles en MCP/OpenAPI)
|
|
172
|
+
ahora documentan el campo `reviewRequired` y la regla operativa: las
|
|
173
|
+
tareas pendientes deben tratarse como tentativas, sin construir trabajo
|
|
174
|
+
derivado encima.
|
|
175
|
+
|
|
176
|
+
## [0.1.0] — 2026-04-23
|
|
177
|
+
|
|
178
|
+
Primera publicación pública en npm como
|
|
179
|
+
[`@roilab/crm-cli`](https://www.npmjs.com/package/@roilab/crm-cli).
|
|
180
|
+
|
|
181
|
+
### Added
|
|
182
|
+
- Flujo de dispositivo (OAuth-style) para login sin pegar API keys en disco.
|
|
183
|
+
Tokens corto/largo con rotación (`crm_at_` / `crm_rt_`).
|
|
184
|
+
- Sustantivos: `auth`, `task`, `comment`, `client`, `domain`, `backlink`,
|
|
185
|
+
`change`, `scope`, `competitor`, `tag`, `member`, `recall`, `search`,
|
|
186
|
+
`inbox`, `review`, `doctor`.
|
|
187
|
+
- Flag `--shadow` para forzar que una escritura aterrice como propuesta
|
|
188
|
+
pendiente de revisión humana.
|
|
189
|
+
- Flag `--wait-for-approval --timeout <dur>` para bloquear hasta decisión
|
|
190
|
+
humana.
|
|
191
|
+
- `crm recall <url>` como memoria cross-entity antes de crear trabajo nuevo.
|
|
192
|
+
- Comprobación diaria de versión contra el registro de npm; `crm doctor`
|
|
193
|
+
avisa cuando hay una versión más reciente. Nudge en stderr, sin bloquear
|
|
194
|
+
stdout JSON.
|
|
195
|
+
- Todas las cadenas visibles en español.
|