@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 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.4.0] — 2026-05-12
12
-
13
- ### Added
14
-
15
- - **Task participants completos.** `task create` y `task update` aceptan
16
- `--collaborator <id...>` (followers — notificados pero no responsables) además
17
- de `--assignee`. También cierra otros huecos del registro REST que el CLI no
18
- exponía: `--start <date>`, `--completion-strategy <all|any|manual>`,
19
- `--board <id>` (mover de tablero en `update`), y `--tag <id...>` /
20
- `--assignee <id...>` en `update`. Equivalente Convex: el campo
21
- `tasks.collaborators` ya existía pero no estaba enrutado por el gateway ni
22
- el endpoint REST — ahora sí.
23
- - **`crm backlink {pending,verify,reject,rejection-report}`.** Cubre el flujo
24
- humano de QA de backlinks. `reject` requiere `--reason` estructurado del
25
- catálogo (`spammy_source | wrong_anchor | wrong_target | nofollow_unexpected
26
- | dead_on_arrival | duplicate | policy_violation | other`).
27
- - **`crm review feedback [--retryable-only]`.** Loop de iteración del agente
28
- documentado en `SKILL.md`: lee tus propuestas rechazadas con `rejectionReason`
29
- + `allowRetry` para re-proponer. Mapea a `GET /reviews/feedback`.
30
- - **`crm review bulk-approve` / `bulk-reject`.** Aprueba o rechaza hasta 100
31
- propuestas en una sola llamada. Items por stdin (NDJSON o tokens `kind:id`),
32
- típico encadenado: `crm review list --jq '.data[] | "\(.kind):\(.id)"' | crm
33
- review bulk-approve`.
34
- - **`crm report {create,update,delete}`.** Schedules CRUD. Body JSON por
35
- `--body <json | @path | ->` para no aplanar la unión scope/cadence/approval
36
- en flags mutuamente dependientes.
37
- - **`crm access {request,list,approve,deny}`.** Namespace canónico para
38
- solicitudes de acceso vía chat. Las variantes antiguas bajo `crm task
39
- {request-access,list-access-requests,approve-access,deny-access}` siguen
40
- funcionando con un aviso `[DEPRECATED]` en stderr; se retiran en la
41
- próxima release mayor.
42
- - **`crm commands`.** Dump JSON del árbol completo del CLI (verbos, args,
43
- flags) para que los agentes introspeccionen la superficie sin parsear
44
- `--help`. Devuelve `{ data: { tree, flat } }`.
45
- - **`crm dashboard summary --start --end`.** Time-series agregado de todo el
46
- workspace para overviews. Mapea a `GET /dashboard/summary`.
47
- - **`crm domain get <id>`.** Single-domain fetch con tags + propiedades
48
- resueltas. Nuevo endpoint `GET /domains/:id` en el registro REST.
49
- - **`crm time list-task <taskId>`.** Lista entradas de tiempo de una tarea
50
- sin filtro por fecha. Mapea a `GET /tasks/:taskId/time-entries`.
51
-
52
- ### Changed
53
-
54
- - **`task update --client-visible` ahora es simétrico.** Antes era
55
- `--client-visible <bool>` (string parseado). Ahora se usan los flags
56
- booleanos de commander: `--client-visible` para marcar visible,
57
- `--no-client-visible` para marcar interna. Omitir el flag deja la
58
- visibilidad sin cambios. `task create --client-visible` ya era el flag
59
- booleano correcto.
60
- - **Notificación de actualización a usuarios — dos canales nuevos:**
61
- - **Cache auto-refresh en segundo plano.** Al ejecutar cualquier comando
62
- el CLI lanza un hijo *detached* (no bloquea el foreground) que
63
- refresca `~/.config/crm/cache.json` contra `registry.npmjs.org` cuando
64
- está caducada (>24h) o no existe. Antes solo `crm doctor` refrescaba;
65
- ahora cualquier invocación cierra el hueco "nunca corro doctor". El
66
- nudge instantáneo (`maybeNudgeFromCache`) sigue siendo síncrono y sin
67
- red — el hijo solo escribe la cache para la siguiente invocación.
68
- - **`User-Agent` + `X-Crm-Cli-Version` en cada llamada HTTP.** El
69
- servidor compara contra `RECOMMENDED_CLI_VERSION` y `MIN_CLI_VERSION`
70
- en `src/lib/cli-version-policy.ts`. Si el caller va por detrás, estampa
71
- `meta.cliUpdate: { current, recommended, severity }` en cada envelope
72
- (tanto éxito como error, también en replays idempotentes). El CLI lee
73
- `meta.cliUpdate` y muestra un aviso por stderr una vez por proceso —
74
- "soft" para upgrades recomendados, "ATENCIÓN" para versiones por
75
- debajo del mínimo. Mecanismo controlado para forzar avisos sin esperar
76
- a la TTL de cache de 24h.
77
-
78
- ## [0.3.0] — 2026-05-04
79
-
80
- ### Added
81
- - `crm task preflight --title <t> [--url <u>] [--domain <id>]` — bundle de
82
- un round-trip que un agente debe ejecutar **antes** de cualquier
83
- `crm task create`. Devuelve seis secciones acotadas (≤5 items por
84
- defecto): `similarTasks` (FTS de título re-rankeado por Jaccard +
85
- recencia + bonus same-domain), `recall` (cuando pasas `--url` —
86
- fan-out por URL como en `crm recall`, capeado a 10), `recentChanges`,
87
- `urlScopedTasks` (tareas abiertas ya enlazadas a esa URL),
88
- `recentBacklinks`, `openTaskCounts` del dominio y `hints[]` en
89
- español. El `summary` del envelope prioriza la pista accionable
90
- (duplicado → cargas en URL → similares → adelante).
91
- Equivalente REST: `GET /tasks/preflight?title=…&url=…&domainId=…`.
92
- - Skill bundle nuevo `task-preflight` (lazy) con árbol de decisión:
93
- cuándo NO crear, cuándo cargar GSC/GA4 vivo después del preflight,
94
- anti-patrones, ejemplo realista. Cárgalo sólo si el envelope deja
95
- al agente en duda — el `summary` resuelve el 80% de los casos.
96
-
97
- ### Changed
98
- - `cli/SKILL.md` — la regla operativa #1 pasa de "always recall before
99
- creating" a el **ritual obligatorio del preflight**. Documenta que no
100
- hay que pre-crawlear con Screaming Frog para entender una URL puntual
101
- (usa `WebFetch` 1-shot) y que GSC/GA4 vivos se llaman *después* del
102
- preflight, no antes.
103
- - `tool-routing` añade fila para "decidir si crear tarea" → apunta a
104
- `task-preflight` antes de cargar cualquier otro skill.
105
-
106
- ## [0.2.0] — 2026-05-01
107
-
108
- ### Added
109
- - `crm task list --review-pending` y `--review-acked` para filtrar tareas
110
- según `reviewRequired`. Útil para que un agente encuentre rápidamente las
111
- tareas que él mismo creó y siguen pendientes de validación humana.
112
- Equivalente REST: `GET /tasks?reviewRequired=true|false`.
113
- - Banner `⚠ REVISAR` en el formato `--markdown`/`--styled`: cuando una fila
114
- individual tiene `reviewRequired: true` la salida se prefija con un aviso
115
- recordando que la tarea es tentativa hasta que un humano la valide; en
116
- listados, cada fila pendiente se anota inline y el footer cuenta cuántas
117
- hay pendientes.
118
-
119
- ### Changed
120
- - Las descripciones de `list_tasks` y `get_task` (visibles en MCP/OpenAPI)
121
- ahora documentan el campo `reviewRequired` y la regla operativa: las
122
- tareas pendientes deben tratarse como tentativas, sin construir trabajo
123
- derivado encima.
124
-
125
- ## [0.1.0] — 2026-04-23
126
-
127
- Primera publicación pública en npm como
128
- [`@roilab/crm-cli`](https://www.npmjs.com/package/@roilab/crm-cli).
129
-
130
- ### Added
131
- - Flujo de dispositivo (OAuth-style) para login sin pegar API keys en disco.
132
- Tokens corto/largo con rotación (`crm_at_` / `crm_rt_`).
133
- - Sustantivos: `auth`, `task`, `comment`, `client`, `domain`, `backlink`,
134
- `change`, `scope`, `competitor`, `tag`, `member`, `recall`, `search`,
135
- `inbox`, `review`, `doctor`.
136
- - Flag `--shadow` para forzar que una escritura aterrice como propuesta
137
- pendiente de revisión humana.
138
- - Flag `--wait-for-approval --timeout <dur>` para bloquear hasta decisión
139
- humana.
140
- - `crm recall <url>` como memoria cross-entity antes de crear trabajo nuevo.
141
- - Comprobación diaria de versión contra el registro de npm; `crm doctor`
142
- avisa cuando hay una versión más reciente. Nudge en stderr, sin bloquear
143
- stdout JSON.
144
- - Todas las cadenas visibles en español.
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.