@roilab/crm-cli 0.18.0 → 0.21.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.
Files changed (43) hide show
  1. package/CHANGELOG.md +114 -0
  2. package/LICENSE +21 -21
  3. package/README.md +156 -119
  4. package/SKILL.md +116 -4
  5. package/SURFACE.txt +84 -24
  6. package/dist/bin/crm.js +11 -6
  7. package/dist/bin/crm.js.map +1 -1
  8. package/dist/src/commands/change.js +314 -0
  9. package/dist/src/commands/change.js.map +1 -0
  10. package/dist/src/commands/doc.js +21 -7
  11. package/dist/src/commands/doc.js.map +1 -1
  12. package/dist/src/commands/generic.js +76 -39
  13. package/dist/src/commands/generic.js.map +1 -1
  14. package/dist/src/commands/options.js +8 -1
  15. package/dist/src/commands/options.js.map +1 -1
  16. package/dist/src/commands/review.js +1 -1
  17. package/dist/src/commands/review.js.map +1 -1
  18. package/dist/src/commands/site.js +268 -0
  19. package/dist/src/commands/site.js.map +1 -0
  20. package/dist/src/commands/task-verify.js +197 -0
  21. package/dist/src/commands/task-verify.js.map +1 -0
  22. package/dist/src/commands/task.js +15 -28
  23. package/dist/src/commands/task.js.map +1 -1
  24. package/dist/src/transport/usage.js +137 -0
  25. package/dist/src/transport/usage.js.map +1 -0
  26. package/dist/src/types.js +7 -1
  27. package/dist/src/types.js.map +1 -1
  28. package/package.json +58 -58
  29. package/skill-bundles/tools/ahrefs-tool/SKILL.md +5 -5
  30. package/skill-bundles/tools/brightlocal-tool/SKILL.md +5 -5
  31. package/skill-bundles/tools/dataforseo-tool/SKILL.md +5 -5
  32. package/skill-bundles/tools/google-analytics-tool/SKILL.md +5 -5
  33. package/skill-bundles/tools/google-search-console-tool/SKILL.md +5 -5
  34. package/skill-bundles/tools/local-falcon-tool/SKILL.md +5 -5
  35. package/skill-bundles/tools/localseodata-tool/SKILL.md +5 -5
  36. package/skill-bundles/tools/lsa-spy-tool/SKILL.md +5 -5
  37. package/skill-bundles/tools/screaming-frog-tool/SKILL.md +5 -5
  38. package/skill-bundles/tools/semrush-tool/SKILL.md +5 -5
  39. package/skill-bundles/tools/serpapi-tool/SKILL.md +5 -5
  40. package/skill-bundles/tools/task-preflight/SKILL.md +157 -157
  41. package/skill-bundles/tools/whitespark-tool/SKILL.md +5 -5
  42. package/dist/src/commands/marketplace.js +0 -158
  43. package/dist/src/commands/marketplace.js.map +0 -1
@@ -0,0 +1,268 @@
1
+ /**
2
+ * `crm site` — conector de webs: leer y cambiar la tienda (PrestaShop) y el
3
+ * blog (WordPress) de un dominio con la credencial guardada en el CRM.
4
+ *
5
+ * - `list` webs conectadas que puedes usar (sin secretos).
6
+ * - `test` prueba la credencial de una conexión.
7
+ * - `rules` reglas de publicación de la web (obligatorias antes de escribir).
8
+ * - `get` campos editables de una página, tal como están ahora.
9
+ * - `update` cambia campos, comprueba la página publicada y lo deja en el
10
+ * registro de cambios de la tarea (con antes y después reales).
11
+ *
12
+ * Los textos largos o con acentos (contenido HTML, metas) entran por fichero
13
+ * (`--content-file`, `--meta-title-file`…): en Windows los argumentos con
14
+ * saltos de línea, comillas o acentos se rompen por el camino del shell. Los
15
+ * ficheros se leen como UTF-8 y se les quita el BOM que mete PowerShell.
16
+ */
17
+ import { readFileSync } from "node:fs";
18
+ import { run } from "../transport/run.js";
19
+ import { outputFromFlags, readFlags } from "./options.js";
20
+ function usageError(message) {
21
+ process.stderr.write(`error: ${message}\n`);
22
+ process.exit(2);
23
+ }
24
+ function readText(path, flag) {
25
+ try {
26
+ return readFileSync(path, "utf8").replace(/^/, "");
27
+ }
28
+ catch (err) {
29
+ usageError(`no se pudo leer ${flag}: ${err instanceof Error ? err.message : String(err)}`);
30
+ }
31
+ }
32
+ /** Valor de un campo desde `--x` o `--x-file` (excluyentes). */
33
+ function pick(inline, file, flag) {
34
+ if (inline !== undefined && file !== undefined)
35
+ usageError(`--${flag} y --${flag}-file son excluyentes`);
36
+ if (file !== undefined)
37
+ return readText(file, `--${flag}-file`);
38
+ return inline;
39
+ }
40
+ /** Cuerpo de POST /sites/update a partir de las opciones (exportado para tests). */
41
+ export function buildSiteUpdateBody(opts) {
42
+ const changes = {};
43
+ const h1 = pick(opts.h1, opts.h1File, "h1");
44
+ const metaTitle = pick(opts.metaTitle, opts.metaTitleFile, "meta-title");
45
+ const metaDescription = pick(opts.metaDesc, opts.metaDescFile, "meta-desc");
46
+ const content = pick(opts.content, opts.contentFile, "content");
47
+ const summary = pick(opts.summary, opts.summaryFile, "summary");
48
+ if (h1 !== undefined)
49
+ changes.h1 = h1;
50
+ if (metaTitle !== undefined)
51
+ changes.metaTitle = metaTitle;
52
+ if (metaDescription !== undefined)
53
+ changes.metaDescription = metaDescription;
54
+ if (content !== undefined)
55
+ changes.content = content;
56
+ if (summary !== undefined)
57
+ changes.summary = summary;
58
+ if (opts.author !== undefined)
59
+ changes.author = opts.author.trim();
60
+ if (Object.keys(changes).length === 0) {
61
+ usageError("indica al menos un campo: --h1, --meta-title, --meta-desc, --content-file, --summary-file o --author");
62
+ }
63
+ const note = pick(opts.note, opts.noteFile, "note");
64
+ return {
65
+ taskId: opts.task,
66
+ url: opts.url,
67
+ ...(opts.ref ? { ref: opts.ref } : {}),
68
+ ...(opts.connection ? { connectionId: opts.connection } : {}),
69
+ changes,
70
+ ...(note !== undefined ? { note } : {}),
71
+ ...(opts.dryRun ? { dryRun: true } : {}),
72
+ };
73
+ }
74
+ export function registerSite(program) {
75
+ const site = program
76
+ .command("site")
77
+ .description("Conector de webs: leer y cambiar la tienda (PrestaShop) y el blog (WordPress) con la credencial guardada en el CRM");
78
+ site
79
+ .command("list")
80
+ .description("Webs conectadas que puedes usar: plataforma, raíz, tienda/idioma (PrestaShop) y estado. Nunca muestra la credencial")
81
+ .option("--domain <id>", "solo las de este dominio (id ms7…)")
82
+ .action(async (opts, cmd) => {
83
+ const flags = readFlags(cmd);
84
+ await run({
85
+ method: "GET",
86
+ path: "/sites",
87
+ request: { query: { domainId: opts.domain } },
88
+ output: outputFromFlags(flags),
89
+ profile: flags.profile,
90
+ });
91
+ });
92
+ site
93
+ .command("test")
94
+ .description("Prueba la credencial de una conexión (usuario y rol en WordPress, mu-plugin de SEO; acceso al webservice en PrestaShop)")
95
+ .argument("<connection-id>", "id de la conexión (crm site list)")
96
+ .action(async (id, _opts, cmd) => {
97
+ const flags = readFlags(cmd);
98
+ await run({
99
+ method: "POST",
100
+ path: `/sites/${encodeURIComponent(id)}/test`,
101
+ request: { body: {}, idempotencyKey: flags.idempotencyKey },
102
+ output: outputFromFlags(flags),
103
+ profile: flags.profile,
104
+ asAgent: flags.asAgent,
105
+ });
106
+ });
107
+ site
108
+ .command("rules")
109
+ .description("Reglas de publicación de una web: perfil del dominio, normas, comprobaciones y el texto de las skills y documentos que aplican. " +
110
+ "Hay que leerlas antes de escribir (crm site update las exige) y aplicarlas al redactar")
111
+ .option("--url <url>", "URL de una página de la web")
112
+ .option("--connection <id>", "o el id de la conexión (crm site list)")
113
+ .action(async (opts, cmd) => {
114
+ const flags = readFlags(cmd);
115
+ if (!opts.url && !opts.connection)
116
+ usageError("indica --url o --connection");
117
+ await run({
118
+ method: "GET",
119
+ path: "/sites/rules",
120
+ request: { query: { url: opts.url, connectionId: opts.connection } },
121
+ output: outputFromFlags(flags),
122
+ profile: flags.profile,
123
+ asAgent: flags.asAgent,
124
+ });
125
+ });
126
+ site
127
+ .command("get")
128
+ .description("Lee los campos editables de una página tal como están ahora en la web: h1, metaTitle, metaDescription, content (HTML) y summary. Úsalo siempre antes de cambiar nada")
129
+ .option("--url <url>", "URL pública de la página")
130
+ .option("--ref <tipo:id>", "en vez de la URL: post:<id>, page:<id>, product:<id>, category:<id>, cms:<id>")
131
+ .option("--connection <id>", "fuerza la conexión (con --ref, o si la URL es ambigua)")
132
+ .action(async (opts, cmd) => {
133
+ const flags = readFlags(cmd);
134
+ if (!opts.url && !opts.ref)
135
+ usageError("indica --url o --ref");
136
+ await run({
137
+ method: "GET",
138
+ path: "/sites/page",
139
+ request: { query: { url: opts.url, ref: opts.ref, connectionId: opts.connection } },
140
+ output: outputFromFlags(flags),
141
+ profile: flags.profile,
142
+ });
143
+ });
144
+ site
145
+ .command("update")
146
+ .description("Cambia campos de una página y lo deja en el registro de cambios de la tarea (antes y después reales). " +
147
+ "Escribe solo lo que cambia, vuelve a leer la página para confirmar lo guardado y comprueba la página publicada. " +
148
+ "La URL entra en el seguimiento de la tarea (ámbito de su revisión de métricas). Prueba antes con --dry-run")
149
+ .requiredOption("--task <id>", "tarea a la que se ancla el cambio (del mismo dominio que la web)")
150
+ .requiredOption("--url <url>", "URL pública de la página")
151
+ .option("--ref <tipo:id>", "desambigua la página: post:<id>, page:<id>, product:<id>, category:<id>, cms:<id>")
152
+ .option("--connection <id>", "fuerza la conexión")
153
+ .option("--h1 <texto>", "H1: título del post/página, nombre del producto o la categoría, título del CMS")
154
+ .option("--h1-file <ruta>", "lee --h1 de un fichero UTF-8")
155
+ .option("--meta-title <texto>", "meta title")
156
+ .option("--meta-title-file <ruta>", "lee --meta-title de un fichero UTF-8")
157
+ .option("--meta-desc <texto>", "meta description")
158
+ .option("--meta-desc-file <ruta>", "lee --meta-desc de un fichero UTF-8")
159
+ .option("--content <html>", "contenido HTML (mejor --content-file)")
160
+ .option("--content-file <ruta>", "contenido HTML completo desde un fichero UTF-8 (parte de `crm site get` y edita)")
161
+ .option("--summary <html>", "extracto (WP), descripción corta (producto) o descripción adicional (categoría)")
162
+ .option("--summary-file <ruta>", "lee --summary de un fichero UTF-8")
163
+ .option("--author <id>", "WordPress: id del usuario autor (las reglas de la web dicen cuál es el habitual)")
164
+ .option("--note <texto>", "por qué se cambia (va al registro de cambios)")
165
+ .option("--note-file <ruta>", "lee --note de un fichero UTF-8")
166
+ .option("--dry-run", "solo enseña el diff; no escribe")
167
+ .action(async (opts, cmd) => {
168
+ const flags = readFlags(cmd);
169
+ await run({
170
+ method: "POST",
171
+ path: "/sites/update",
172
+ request: { body: buildSiteUpdateBody(opts), idempotencyKey: flags.idempotencyKey },
173
+ output: outputFromFlags(flags),
174
+ profile: flags.profile,
175
+ asAgent: flags.asAgent,
176
+ });
177
+ });
178
+ }
179
+ const PATTERN_OPS = ["regex", "contains", "not_regex", "not_contains"];
180
+ /** Cuerpo de PATCH /tasks/:id/tracking (exportado para tests). */
181
+ export function buildTrackingBody(opts) {
182
+ const modes = [opts.urls !== undefined || opts.urlsFile !== undefined, opts.pattern !== undefined, !!opts.domain].filter(Boolean).length;
183
+ if (modes > 1)
184
+ usageError("elige un solo ámbito: --urls/--urls-file, --pattern o --domain");
185
+ const body = {};
186
+ if (opts.urls !== undefined || opts.urlsFile !== undefined) {
187
+ if (opts.urls !== undefined && opts.urlsFile !== undefined)
188
+ usageError("--urls y --urls-file son excluyentes");
189
+ const raw = opts.urlsFile !== undefined ? readText(opts.urlsFile, "--urls-file") : opts.urls;
190
+ const urls = raw.split(/[\s,]+/).map((u) => u.trim()).filter(Boolean);
191
+ if (urls.length === 0)
192
+ usageError("--urls no trae ninguna URL");
193
+ body.mode = "urls";
194
+ body.urls = urls;
195
+ }
196
+ if (opts.addUrl?.length)
197
+ body.addUrls = opts.addUrl;
198
+ if (opts.pattern !== undefined) {
199
+ const operator = opts.operator ?? "regex";
200
+ if (!PATTERN_OPS.includes(operator))
201
+ usageError(`--operator debe ser ${PATTERN_OPS.join(" | ")}`);
202
+ body.mode = "pattern";
203
+ body.pattern = { operator, value: opts.pattern };
204
+ }
205
+ else if (opts.operator !== undefined) {
206
+ usageError("--operator solo vale junto a --pattern");
207
+ }
208
+ if (opts.domain)
209
+ body.mode = "domain";
210
+ if (opts.verifyDays !== undefined) {
211
+ const n = Number(opts.verifyDays.replace(/d$/i, ""));
212
+ if (!Number.isInteger(n))
213
+ usageError(`--verify-days espera un número de días, no "${opts.verifyDays}"`);
214
+ body.verifyDays = n;
215
+ }
216
+ if (opts.autoVerify === false)
217
+ body.autoVerify = false;
218
+ if (opts.autoVerify === true)
219
+ body.autoVerify = true;
220
+ if (Object.keys(body).length === 0)
221
+ usageError("no hay nada que cambiar: usa --urls, --add-url, --pattern, --domain, --verify-days o --[no-]auto-verify");
222
+ return body;
223
+ }
224
+ /** `crm task tracking` — se cuelga del comando `task`. */
225
+ export function registerTaskTracking(task) {
226
+ const tracking = task
227
+ .command("tracking")
228
+ .description("Seguimiento de URLs de una tarea: qué páginas tocó y qué medirá su revisión de métricas (URLs, patrón o dominio entero)");
229
+ tracking
230
+ .command("get")
231
+ .description("URLs tocadas, ámbito de medición, filtro de Search Console resultante y revisión automática")
232
+ .argument("<task-id>", "id de tarea")
233
+ .action(async (taskId, _opts, cmd) => {
234
+ const flags = readFlags(cmd);
235
+ await run({
236
+ method: "GET",
237
+ path: `/tasks/${encodeURIComponent(taskId)}/tracking`,
238
+ output: outputFromFlags(flags),
239
+ profile: flags.profile,
240
+ });
241
+ });
242
+ tracking
243
+ .command("set")
244
+ .description("Fija qué mide la revisión de métricas: --urls (lista exacta), --pattern (p. ej. '\\.html$' = todas las fichas) o --domain (propiedad entera). " +
245
+ "Cada cambio registrado en la tarea ya añade su URL solo; esto es para ampliarlo o cambiar de ámbito")
246
+ .argument("<task-id>", "id de tarea")
247
+ .option("--urls <lista>", "sustituye la lista: URLs separadas por comas o espacios")
248
+ .option("--urls-file <ruta>", "sustituye la lista: una URL por línea (UTF-8)")
249
+ .option("--add-url <url...>", "añade una o varias URLs a la lista")
250
+ .option("--pattern <expresión>", "filtro de página de Search Console (RE2, sin lookahead)")
251
+ .option("--operator <op>", `con --pattern: ${PATTERN_OPS.join(" | ")} (por defecto regex)`)
252
+ .option("--domain", "mide la propiedad entera")
253
+ .option("--verify-days <n>", "días desde el cierre hasta la revisión automática (3-180, por defecto 28)")
254
+ .option("--auto-verify", "programa la revisión al completar la tarea (por defecto)")
255
+ .option("--no-auto-verify", "no programar la revisión automáticamente")
256
+ .action(async (taskId, opts, cmd) => {
257
+ const flags = readFlags(cmd);
258
+ await run({
259
+ method: "PATCH",
260
+ path: `/tasks/${encodeURIComponent(taskId)}/tracking`,
261
+ request: { body: buildTrackingBody(opts), idempotencyKey: flags.idempotencyKey },
262
+ output: outputFromFlags(flags),
263
+ profile: flags.profile,
264
+ asAgent: flags.asAgent,
265
+ });
266
+ });
267
+ }
268
+ //# sourceMappingURL=site.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"site.js","sourceRoot":"","sources":["../../../src/commands/site.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,197 @@
1
+ /**
2
+ * `crm task verify` — revisión de métricas de tareas aplicadas.
3
+ *
4
+ * Una tarea SEO se completa el día que se aplica el cambio y se revisa
5
+ * semanas después: ese día pasa a la cola (`list`) con la comparación de
6
+ * métricas antes/después ya calculada. Un agente analiza (`show` + recall +
7
+ * GSC) y PROPONE un veredicto (`resolve`); una persona lo confirma en la
8
+ * bandeja. Ver `cli/SKILL.md` § Revisión de métricas.
9
+ */
10
+ import { readFileSync } from "node:fs";
11
+ import { run } from "../transport/run.js";
12
+ import { outputFromFlags, readFlags } from "./options.js";
13
+ const VERDICTS = ["positive", "neutral", "negative", "inconclusive"];
14
+ const STATES = ["actionable", "scheduled", "resolved", "open"];
15
+ function usageError(message) {
16
+ process.stderr.write(`error: ${message}\n`);
17
+ process.exit(2);
18
+ }
19
+ /** `--in 30` / `--in 30d` → 30. */
20
+ function parseDays(raw) {
21
+ const m = /^(\d+)\s*d?$/i.exec(raw.trim());
22
+ if (!m)
23
+ usageError(`--in espera un número de días (p. ej. 30 o 30d), no "${raw}"`);
24
+ return Number(m[1]);
25
+ }
26
+ /** Fecha de revisión: exactamente una de `--in` / `--at`. */
27
+ function whenBody(opts) {
28
+ if ((opts.in === undefined) === (opts.at === undefined)) {
29
+ usageError("indica --in <días> o --at <AAAA-MM-DD> (uno de los dos)");
30
+ }
31
+ if (opts.at !== undefined) {
32
+ if (!/^\d{4}-\d{2}-\d{2}$/.test(opts.at.trim())) {
33
+ usageError(`--at espera AAAA-MM-DD, no "${opts.at}"`);
34
+ }
35
+ return { at: opts.at.trim() };
36
+ }
37
+ return { inDays: parseDays(opts.in) };
38
+ }
39
+ /** Nota del veredicto desde `--note` o `--note-file` (multilínea sin pasar
40
+ * por el shell — `--note "$(cat x.md)"` se trunca en el primer backtick). */
41
+ function resolveNote(inline, filePath) {
42
+ if (inline !== undefined && filePath !== undefined) {
43
+ usageError("--note y --note-file son mutuamente excluyentes");
44
+ }
45
+ if (filePath === undefined)
46
+ return inline;
47
+ try {
48
+ return readFileSync(filePath, "utf8");
49
+ }
50
+ catch (err) {
51
+ const msg = err instanceof Error ? err.message : String(err);
52
+ usageError(`no se pudo leer --note-file: ${msg}`);
53
+ }
54
+ }
55
+ export function registerTaskVerify(task) {
56
+ const verify = task
57
+ .command("verify")
58
+ .description("Revisión de métricas de tareas aplicadas: programar, cola de vencidas, análisis y veredicto");
59
+ verify
60
+ .command("list")
61
+ .description("Cola de revisiones. Por defecto las que piden acción (vencidas + propuestas), con la foto antes/después")
62
+ .option("--state <estado>", `${STATES.join(" | ")} (por defecto actionable)`, "actionable")
63
+ .option("--domain <id>", "filtra por id de dominio")
64
+ .option("--client <id>", "filtra por id de cliente")
65
+ .action(async (opts, cmd) => {
66
+ const flags = readFlags(cmd);
67
+ if (!STATES.includes(opts.state)) {
68
+ usageError(`--state debe ser ${STATES.join(" | ")}`);
69
+ }
70
+ await run({
71
+ method: "GET",
72
+ path: "/tasks/verifications",
73
+ request: {
74
+ query: {
75
+ state: opts.state,
76
+ domainId: opts.domain,
77
+ clientId: opts.client,
78
+ limit: flags.limit,
79
+ },
80
+ },
81
+ output: outputFromFlags(flags),
82
+ profile: flags.profile,
83
+ });
84
+ });
85
+ verify
86
+ .command("show")
87
+ .description("Revisión de una tarea: criterio, foto de métricas, metas de ranking, propuesta y veredicto")
88
+ .argument("<task-id>", "id de tarea")
89
+ .action(async (taskId, _opts, cmd) => {
90
+ const flags = readFlags(cmd);
91
+ await run({
92
+ method: "GET",
93
+ path: `/tasks/${encodeURIComponent(taskId)}/verification`,
94
+ output: outputFromFlags(flags),
95
+ profile: flags.profile,
96
+ });
97
+ });
98
+ verify
99
+ .command("schedule")
100
+ .description("Programa (o reprograma) la revisión de métricas de una tarea completada. Con --complete la completa en el mismo paso")
101
+ .argument("<task-id>", "id de tarea")
102
+ .option("--in <días>", "revisar dentro de N días (3-365), p. ej. 30 o 30d")
103
+ .option("--at <AAAA-MM-DD>", "revisar en esa fecha")
104
+ .option("--criteria <texto>", "criterio de éxito (opcional, máx. 280; cadena vacía lo borra)")
105
+ .option("--complete", "marca la tarea como completada antes de programar")
106
+ .action(async (taskId, opts, cmd) => {
107
+ const flags = readFlags(cmd);
108
+ await run({
109
+ method: "POST",
110
+ path: `/tasks/${encodeURIComponent(taskId)}/verification`,
111
+ request: {
112
+ body: {
113
+ ...whenBody(opts),
114
+ ...(opts.criteria !== undefined ? { criteria: opts.criteria } : {}),
115
+ ...(opts.complete ? { complete: true } : {}),
116
+ },
117
+ idempotencyKey: flags.idempotencyKey,
118
+ },
119
+ output: outputFromFlags(flags),
120
+ profile: flags.profile,
121
+ asAgent: flags.asAgent,
122
+ });
123
+ });
124
+ verify
125
+ .command("snooze")
126
+ .description("Pospone una revisión (vuelve a programada y descarta la propuesta; se medirá de nuevo)")
127
+ .argument("<task-id>", "id de tarea")
128
+ .option("--in <días>", "posponer N días (3-365)")
129
+ .option("--at <AAAA-MM-DD>", "nueva fecha")
130
+ .action(async (taskId, opts, cmd) => {
131
+ const flags = readFlags(cmd);
132
+ await run({
133
+ method: "POST",
134
+ path: `/tasks/${encodeURIComponent(taskId)}/verification`,
135
+ request: { body: whenBody(opts), idempotencyKey: flags.idempotencyKey },
136
+ output: outputFromFlags(flags),
137
+ profile: flags.profile,
138
+ asAgent: flags.asAgent,
139
+ });
140
+ });
141
+ verify
142
+ .command("resolve")
143
+ .description("Veredicto de la revisión. Persona: la cierra. Agente: queda como PROPUESTA que confirma una persona (nota obligatoria)")
144
+ .argument("<task-id>", "id de tarea")
145
+ .requiredOption("--verdict <veredicto>", VERDICTS.join(" | "))
146
+ .option("--note <texto>", "análisis / motivo (máx. 2000)")
147
+ .option("--note-file <ruta>", "lee la nota de un fichero (multilínea)")
148
+ .action(async (taskId, opts, cmd) => {
149
+ const flags = readFlags(cmd);
150
+ if (!VERDICTS.includes(opts.verdict)) {
151
+ usageError(`--verdict debe ser ${VERDICTS.join(" | ")}`);
152
+ }
153
+ const note = resolveNote(opts.note, opts.noteFile);
154
+ await run({
155
+ method: "POST",
156
+ path: `/tasks/${encodeURIComponent(taskId)}/verification/resolve`,
157
+ request: {
158
+ body: { verdict: opts.verdict, ...(note !== undefined ? { note } : {}) },
159
+ idempotencyKey: flags.idempotencyKey,
160
+ },
161
+ output: outputFromFlags(flags),
162
+ profile: flags.profile,
163
+ asAgent: flags.asAgent,
164
+ });
165
+ });
166
+ verify
167
+ .command("measure")
168
+ .description("Recalcula la foto de métricas de una revisión abierta (máx. una vez por hora)")
169
+ .argument("<task-id>", "id de tarea")
170
+ .action(async (taskId, _opts, cmd) => {
171
+ const flags = readFlags(cmd);
172
+ await run({
173
+ method: "POST",
174
+ path: `/tasks/${encodeURIComponent(taskId)}/verification/measure`,
175
+ request: { body: {}, idempotencyKey: flags.idempotencyKey },
176
+ output: outputFromFlags(flags),
177
+ profile: flags.profile,
178
+ asAgent: flags.asAgent,
179
+ });
180
+ });
181
+ verify
182
+ .command("clear")
183
+ .description("Quita la revisión abierta (la tarea sigue completada)")
184
+ .argument("<task-id>", "id de tarea")
185
+ .action(async (taskId, _opts, cmd) => {
186
+ const flags = readFlags(cmd);
187
+ await run({
188
+ method: "DELETE",
189
+ path: `/tasks/${encodeURIComponent(taskId)}/verification`,
190
+ request: { idempotencyKey: flags.idempotencyKey },
191
+ output: outputFromFlags(flags),
192
+ profile: flags.profile,
193
+ asAgent: flags.asAgent,
194
+ });
195
+ });
196
+ }
197
+ //# sourceMappingURL=task-verify.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-verify.js","sourceRoot":"","sources":["../../../src/commands/task-verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,QAAQ,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,CAAU,CAAC;AAC9E,MAAM,MAAM,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC;AAExE,SAAS,UAAU,CAAC,OAAe;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,mCAAmC;AACnC,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC;QAAE,UAAU,CAAC,wDAAwD,GAAG,GAAG,CAAC,CAAC;IACnF,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAED,6DAA6D;AAC7D,SAAS,QAAQ,CAAC,IAAkC;IAClD,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC;QACxD,UAAU,CAAC,yDAAyD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAChD,UAAU,CAAC,+BAA+B,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,EAAY,CAAC,EAAE,CAAC;AAClD,CAAC;AAED;8EAC8E;AAC9E,SAAS,WAAW,CAAC,MAA0B,EAAE,QAA4B;IAC3E,IAAI,MAAM,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnD,UAAU,CAAC,iDAAiD,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,UAAU,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,MAAM,MAAM,GAAG,IAAI;SAChB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CACV,6FAA6F,CAC9F,CAAC;IAEJ,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,yGAAyG,CAC1G;SACA,MAAM,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,2BAA2B,EAAE,YAAY,CAAC;SAC1F,MAAM,CAAC,eAAe,EAAE,0BAA0B,CAAC;SACnD,MAAM,CAAC,eAAe,EAAE,0BAA0B,CAAC;SACnD,MAAM,CACL,KAAK,EAAE,IAAyD,EAAE,GAAY,EAAE,EAAE;QAChF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAE,MAA4B,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,UAAU,CAAC,oBAAoB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE;gBACP,KAAK,EAAE;oBACL,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,QAAQ,EAAE,IAAI,CAAC,MAAM;oBACrB,QAAQ,EAAE,IAAI,CAAC,MAAM;oBACrB,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB;aACF;YACD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEJ,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4FAA4F,CAAC;SACzG,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;SACpC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,KAAK,EAAE,GAAY,EAAE,EAAE;QACpD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,eAAe;YACzD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CACV,sHAAsH,CACvH;SACA,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;SACpC,MAAM,CAAC,aAAa,EAAE,mDAAmD,CAAC;SAC1E,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;SACnD,MAAM,CAAC,oBAAoB,EAAE,+DAA+D,CAAC;SAC7F,MAAM,CAAC,YAAY,EAAE,mDAAmD,CAAC;SACzE,MAAM,CACL,KAAK,EACH,MAAc,EACd,IAAyE,EACzE,GAAY,EACZ,EAAE;QACF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,eAAe;YACzD,OAAO,EAAE;gBACP,IAAI,EAAE;oBACJ,GAAG,QAAQ,CAAC,IAAI,CAAC;oBACjB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC7C;gBACD,cAAc,EAAE,KAAK,CAAC,cAAc;aACrC;YACD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEJ,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,wFAAwF,CAAC;SACrG,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;SACpC,MAAM,CAAC,aAAa,EAAE,yBAAyB,CAAC;SAChD,MAAM,CAAC,mBAAmB,EAAE,aAAa,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAkC,EAAE,GAAY,EAAE,EAAE;QACjF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,eAAe;YACzD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE;YACvE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CACV,wHAAwH,CACzH;SACA,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;SACpC,cAAc,CAAC,uBAAuB,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SAC7D,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;SACzD,MAAM,CAAC,oBAAoB,EAAE,wCAAwC,CAAC;SACtE,MAAM,CACL,KAAK,EACH,MAAc,EACd,IAA2D,EAC3D,GAAY,EACZ,EAAE;QACF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAE,QAA8B,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,UAAU,CAAC,sBAAsB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,uBAAuB;YACjE,OAAO,EAAE;gBACP,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;gBACxE,cAAc,EAAE,KAAK,CAAC,cAAc;aACrC;YACD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEJ,MAAM;SACH,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,+EAA+E,CAAC;SAC5F,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;SACpC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,KAAK,EAAE,GAAY,EAAE,EAAE;QACpD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,uBAAuB;YACjE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE;YAC3D,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,uDAAuD,CAAC;SACpE,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;SACpC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,KAAK,EAAE,GAAY,EAAE,EAAE;QACpD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,eAAe;YACzD,OAAO,EAAE,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE;YACjD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}
@@ -3,6 +3,8 @@ import { readFileSync } from "node:fs";
3
3
  import { run } from "../transport/run.js";
4
4
  import { uploadGenericFiles } from "../lib/fileUpload.js";
5
5
  import { outputFromFlags, parseDurationMs, readFlags } from "./options.js";
6
+ import { registerTaskVerify } from "./task-verify.js";
7
+ import { registerTaskTracking } from "./site.js";
6
8
  /** Resolve a description from `--description` or `--description-file`. Refuses
7
9
  * both at once. Reading from a file dodges the shell-escaping bug where
8
10
  * `--description "$(cat file.md)"` truncates at the first backtick of a fenced
@@ -30,8 +32,8 @@ export function registerTask(program) {
30
32
  .description("Lista tareas con filtros opcionales")
31
33
  .option("--status <status>", "todo | doing | blocked | done")
32
34
  .option("--domain <id>", "filtra por id de dominio")
33
- .option("--board <id>", "filtra por id del tablero de anclaje de la tarea (no incluye tareas multi-home añadidas a ese tablero)")
34
- .option("--column <id>", "filtra por id de columna kanban (combínalo con --board para leer una sola swimlane, p. ej. el backlog)")
35
+ .option("--board <id>", "filtra por id de tablero, incluidas sus tareas multi-home (lo mismo que pinta el kanban)")
36
+ .option("--column <id>", "filtra por la columna en la que la tarea SE PINTA: sin colocación explícita cae en la primera columna de su estado, igual que en el kanban. La columna implica su tablero, así que no hace falta --board")
35
37
  .option("--assignee <id>", "filtra por asignado")
36
38
  .option("--tag <id>", "filtra por etiqueta")
37
39
  .option("--review-pending", "sólo tareas con reviewRequired=true (pendientes de validación humana)")
@@ -169,6 +171,7 @@ export function registerTask(program) {
169
171
  .option("--due <date>", "fecha de entrega (YYYY-MM-DD)")
170
172
  .option("--completion-strategy <s>", "estrategia multi-property: all | any | manual (default: all)")
171
173
  .option("--client-visible", "hace la tarea visible para usuarios cliente")
174
+ .option("--completed-at <date>", "fecha de completado (YYYY-MM-DD o ISO) para una tarea creada en done — solo staff; sin ella se usa la fecha actual")
172
175
  .option("--no-review", "no marca la tarea para revisión humana (solo agentes)")
173
176
  .option("--file <path...>", "ruta a un archivo a adjuntar — repite la bandera para varios (máx 10 MB cada uno; aviso a partir de 2 MB)")
174
177
  .action(async (opts, cmd) => {
@@ -198,6 +201,7 @@ export function registerTask(program) {
198
201
  clientVisible: opts.clientVisible,
199
202
  completionStrategy: opts.completionStrategy,
200
203
  reviewRequired: opts.review,
204
+ completedAt: opts.completedAt,
201
205
  ...(attachments.length > 0 ? { attachments } : {}),
202
206
  ...(flags.shadow ? { shadow: true } : {}),
203
207
  },
@@ -246,6 +250,7 @@ export function registerTask(program) {
246
250
  .option("--completion-strategy <s>", "estrategia multi-property: all | any | manual")
247
251
  .option("--client-visible", "marca la tarea como visible para cliente")
248
252
  .option("--no-client-visible", "marca la tarea como interna (oculta para cliente)")
253
+ .option("--completed-at <date>", "fecha de completado (YYYY-MM-DD o ISO) — solo staff y con la tarea en done (combinable con --status done o --column); no admite fechas futuras")
249
254
  .option("--file <path...>", "añade archivo(s) a los adjuntos existentes — repite la bandera. Máx 10 MB; aviso desde 2 MB")
250
255
  .option("--clear-files", "vacía la lista de adjuntos. Combinable con --file (los archivos nuevos quedan, los antiguos se borran)")
251
256
  .action(async (id, opts, cmd) => {
@@ -290,6 +295,7 @@ export function registerTask(program) {
290
295
  dueDate: opts.due,
291
296
  completionStrategy: opts.completionStrategy,
292
297
  clientVisible: opts.clientVisible,
298
+ completedAt: opts.completedAt,
293
299
  ...(attachmentsPayload !== undefined ? { attachments: attachmentsPayload } : {}),
294
300
  ...(flags.shadow ? { shadow: true } : {}),
295
301
  },
@@ -338,33 +344,11 @@ export function registerTask(program) {
338
344
  asAgent: flags.asAgent,
339
345
  });
340
346
  });
341
- task
342
- .command("link-offer")
343
- .description("Marca una oferta de linkbuilding como FK principal de la tarea.")
344
- .argument("<task-id>", "id de tarea (tsk_...)")
345
- .argument("<offer-id>", "id de oferta")
346
- .option("--unlink", "limpia el FK en lugar de fijarlo a la tarea")
347
- .action(async (taskId, offerId, opts, cmd) => {
348
- const flags = readFlags(cmd);
349
- await run({
350
- method: "POST",
351
- path: `/offers/${encodeURIComponent(offerId)}/link-task`,
352
- request: {
353
- body: {
354
- taskId: opts.unlink ? null : taskId,
355
- },
356
- idempotencyKey: flags.idempotencyKey,
357
- },
358
- output: outputFromFlags(flags),
359
- profile: flags.profile,
360
- asAgent: flags.asAgent,
361
- });
362
- });
363
347
  task
364
348
  .command("complete-with-evidence")
365
- .description("Cierra la tarea citando un backlink u oferta como prueba (Phase 41).")
349
+ .description("Cierra la tarea citando un backlink como prueba (Phase 41).")
366
350
  .argument("<task-id>", "id de tarea (tsk_...)")
367
- .requiredOption("--asset <kind:id>", "asset cit. ej. backlink:k3a4... | offer:k7c1...")
351
+ .requiredOption("--asset <kind:id>", "asset citado, ej. backlink:k3a4...")
368
352
  .option("--comment <id>", "id de comentario que menciona al backlink (recomendado — el server lo verifica)")
369
353
  .action(async (taskId, opts, cmd) => {
370
354
  const flags = readFlags(cmd);
@@ -374,8 +358,8 @@ export function registerTask(program) {
374
358
  }
375
359
  const kind = opts.asset.slice(0, colon);
376
360
  const assetId = opts.asset.slice(colon + 1);
377
- if (kind !== "backlink" && kind !== "offer") {
378
- throw new Error("--asset kind debe ser 'backlink' u 'offer'");
361
+ if (kind !== "backlink") {
362
+ throw new Error("--asset kind debe ser 'backlink' (las ofertas viven en pwn-control)");
379
363
  }
380
364
  await run({
381
365
  method: "POST",
@@ -412,6 +396,9 @@ export function registerTask(program) {
412
396
  asAgent: flags.asAgent,
413
397
  });
414
398
  });
399
+ // ── Revisión de métricas (aplicada → revisar en N días) ───
400
+ registerTaskVerify(task);
401
+ registerTaskTracking(task);
415
402
  // ── Access requests (chat-driven) — deprecated aliases ───
416
403
  // Canonical home is `crm access {request,list,approve,deny}` (commands/access.ts).
417
404
  // The verbs are kept here for one release so existing scripts keep working;