@roilab/crm-cli 0.1.0 → 0.4.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 (67) hide show
  1. package/CHANGELOG.md +125 -6
  2. package/SKILL.md +256 -7
  3. package/SURFACE.txt +148 -3
  4. package/dist/bin/crm.js +26 -2
  5. package/dist/bin/crm.js.map +1 -1
  6. package/dist/src/commands/access.js +104 -0
  7. package/dist/src/commands/access.js.map +1 -0
  8. package/dist/src/commands/brief.js +52 -0
  9. package/dist/src/commands/brief.js.map +1 -0
  10. package/dist/src/commands/chat.js +203 -0
  11. package/dist/src/commands/chat.js.map +1 -0
  12. package/dist/src/commands/commands.js +89 -0
  13. package/dist/src/commands/commands.js.map +1 -0
  14. package/dist/src/commands/comment.js +1 -0
  15. package/dist/src/commands/comment.js.map +1 -1
  16. package/dist/src/commands/generic.js +335 -5
  17. package/dist/src/commands/generic.js.map +1 -1
  18. package/dist/src/commands/integrations.js +236 -0
  19. package/dist/src/commands/integrations.js.map +1 -0
  20. package/dist/src/commands/mention.js +139 -0
  21. package/dist/src/commands/mention.js.map +1 -0
  22. package/dist/src/commands/options.js +21 -1
  23. package/dist/src/commands/options.js.map +1 -1
  24. package/dist/src/commands/report.js +209 -0
  25. package/dist/src/commands/report.js.map +1 -0
  26. package/dist/src/commands/review.js +136 -0
  27. package/dist/src/commands/review.js.map +1 -1
  28. package/dist/src/commands/skill.js +836 -0
  29. package/dist/src/commands/skill.js.map +1 -0
  30. package/dist/src/commands/task.js +298 -4
  31. package/dist/src/commands/task.js.map +1 -1
  32. package/dist/src/commands/time.js +242 -0
  33. package/dist/src/commands/time.js.map +1 -0
  34. package/dist/src/lib/skillBundles.js +84 -0
  35. package/dist/src/lib/skillBundles.js.map +1 -0
  36. package/dist/src/lib/skillManifest.js +77 -0
  37. package/dist/src/lib/skillManifest.js.map +1 -0
  38. package/dist/src/lib/skillSidecar.js +69 -0
  39. package/dist/src/lib/skillSidecar.js.map +1 -0
  40. package/dist/src/lib/skillWriter.js +162 -0
  41. package/dist/src/lib/skillWriter.js.map +1 -0
  42. package/dist/src/transport/envelope.js +12 -2
  43. package/dist/src/transport/envelope.js.map +1 -1
  44. package/dist/src/transport/http.js +27 -0
  45. package/dist/src/transport/http.js.map +1 -1
  46. package/dist/src/transport/run.js +6 -0
  47. package/dist/src/transport/run.js.map +1 -1
  48. package/dist/src/types.js.map +1 -1
  49. package/dist/src/utils/server-nudge.js +57 -0
  50. package/dist/src/utils/server-nudge.js.map +1 -0
  51. package/dist/src/utils/version-check.js +68 -0
  52. package/dist/src/utils/version-check.js.map +1 -1
  53. package/package.json +2 -1
  54. package/skill-bundles/tools/ahrefs-tool/SKILL.md +134 -0
  55. package/skill-bundles/tools/brightlocal-tool/SKILL.md +154 -0
  56. package/skill-bundles/tools/dataforseo-tool/SKILL.md +118 -0
  57. package/skill-bundles/tools/google-analytics-tool/SKILL.md +143 -0
  58. package/skill-bundles/tools/google-search-console-tool/SKILL.md +133 -0
  59. package/skill-bundles/tools/local-falcon-tool/SKILL.md +142 -0
  60. package/skill-bundles/tools/localseodata-tool/SKILL.md +388 -0
  61. package/skill-bundles/tools/lsa-spy-tool/SKILL.md +113 -0
  62. package/skill-bundles/tools/screaming-frog-tool/SKILL.md +166 -0
  63. package/skill-bundles/tools/semrush-tool/SKILL.md +121 -0
  64. package/skill-bundles/tools/serpapi-tool/SKILL.md +148 -0
  65. package/skill-bundles/tools/task-preflight/SKILL.md +149 -0
  66. package/skill-bundles/tools/tool-routing/SKILL.md +59 -0
  67. package/skill-bundles/tools/whitespark-tool/SKILL.md +129 -0
package/dist/bin/crm.js CHANGED
@@ -7,27 +7,51 @@
7
7
  */
8
8
  import { Command } from "commander";
9
9
  import { registerGlobalFlags } from "../src/commands/options.js";
10
+ import { registerAccess } from "../src/commands/access.js";
10
11
  import { registerAuth } from "../src/commands/auth.js";
12
+ import { registerCommands } from "../src/commands/commands.js";
11
13
  import { registerTask } from "../src/commands/task.js";
12
14
  import { registerComment } from "../src/commands/comment.js";
15
+ import { registerChat } from "../src/commands/chat.js";
13
16
  import { registerGeneric } from "../src/commands/generic.js";
14
17
  import { registerDoctor } from "../src/commands/doctor.js";
15
18
  import { registerReview } from "../src/commands/review.js";
16
- import { maybeNudgeFromCache } from "../src/utils/version-check.js";
19
+ import { registerIntegrations } from "../src/commands/integrations.js";
20
+ import { registerSkill } from "../src/commands/skill.js";
21
+ import { registerBrief } from "../src/commands/brief.js";
22
+ import { registerMention } from "../src/commands/mention.js";
23
+ import { registerTime } from "../src/commands/time.js";
24
+ import { registerReport } from "../src/commands/report.js";
25
+ import { maybeNudgeFromCache, readInstalledVersion, refreshCacheInBackground, } from "../src/utils/version-check.js";
17
26
  const program = new Command();
18
27
  program
19
28
  .name("crm")
20
29
  .description("CLI para humanos y agentes de IA que manejan el SEO+CRM de ROILab. Envoltura JSON siempre, exit codes numéricos, escrituras idempotentes.")
21
- .version("0.1.0");
30
+ // Single source of truth: read from package.json so `crm --version`,
31
+ // the `User-Agent` header, and the cache nudge all agree.
32
+ .version(readInstalledVersion());
22
33
  registerGlobalFlags(program);
23
34
  registerAuth(program);
35
+ registerAccess(program);
24
36
  registerTask(program);
25
37
  registerComment(program);
38
+ registerChat(program);
26
39
  registerGeneric(program);
40
+ registerBrief(program);
41
+ registerMention(program);
27
42
  registerReview(program);
43
+ registerIntegrations(program);
44
+ registerSkill(program);
45
+ registerTime(program);
46
+ registerReport(program);
47
+ registerCommands(program);
28
48
  registerDoctor(program);
29
49
  // Nudge basado en cache: instantáneo, sin red. `crm doctor` refresca contra npm.
30
50
  maybeNudgeFromCache();
51
+ // Si la cache está caducada (>24h) o no existe, lanza un hijo desacoplado que
52
+ // la refresque contra el registro de npm. Fire-and-forget — el foreground
53
+ // sigue corriendo sin esperar.
54
+ refreshCacheInBackground();
31
55
  program.parseAsync(process.argv).catch((err) => {
32
56
  process.stderr.write(`[INTERNO] ${err instanceof Error ? err.message : String(err)}\n`);
33
57
  process.exit(1);
@@ -1 +1 @@
1
- {"version":3,"file":"crm.js","sourceRoot":"","sources":["../../bin/crm.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CACV,2IAA2I,CAC5I;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,cAAc,CAAC,OAAO,CAAC,CAAC;AAExB,iFAAiF;AACjF,mBAAmB,EAAE,CAAC;AAEtB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"crm.js","sourceRoot":"","sources":["../../bin/crm.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CACV,2IAA2I,CAC5I;IACD,qEAAqE;IACrE,0DAA0D;KACzD,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAEnC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1B,cAAc,CAAC,OAAO,CAAC,CAAC;AAExB,iFAAiF;AACjF,mBAAmB,EAAE,CAAC;AACtB,8EAA8E;AAC9E,0EAA0E;AAC1E,+BAA+B;AAC/B,wBAAwB,EAAE,CAAC;AAE3B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
@@ -0,0 +1,104 @@
1
+ /**
2
+ * `crm access` — chat-driven access-request workflow.
3
+ *
4
+ * Clients request access to tasks they spotted in chat threads; staff (or
5
+ * client_lead) resolve those requests. These commands wrap the
6
+ * `/access-requests/*` endpoints and are the canonical location of the verbs;
7
+ * the older `crm task request-access` / `task list-access-requests` /
8
+ * `task approve-access` / `task deny-access` aliases remain for one release
9
+ * with a deprecation hint.
10
+ */
11
+ import { run } from "../transport/run.js";
12
+ import { outputFromFlags, readFlags } from "./options.js";
13
+ export function registerAccess(program) {
14
+ const access = program
15
+ .command("access")
16
+ .description("Solicitudes de acceso a tareas (vía chat). Clientes solicitan, staff aprueba/rechaza.");
17
+ access
18
+ .command("request")
19
+ .description("Solicita acceso a una tarea citada en un chat (requiere API key cliente).")
20
+ .argument("<task-id>", "id de tarea (tsk_...)")
21
+ .requiredOption("--via <message-id>", "id del mensaje que cita la tarea — el server verifica que la mención existe")
22
+ .option("--message <text>", "justificación opcional para el aprobador")
23
+ .action(async (taskId, opts, cmd) => {
24
+ const flags = readFlags(cmd);
25
+ await run({
26
+ method: "POST",
27
+ path: "/access-requests/tasks",
28
+ request: {
29
+ body: {
30
+ taskId,
31
+ viaMessageId: opts.via,
32
+ ...(opts.message ? { message: opts.message } : {}),
33
+ },
34
+ idempotencyKey: flags.idempotencyKey,
35
+ },
36
+ output: outputFromFlags(flags),
37
+ profile: flags.profile,
38
+ asAgent: flags.asAgent,
39
+ });
40
+ });
41
+ access
42
+ .command("list")
43
+ .description("Lista solicitudes de acceso a tareas pendientes (staff).")
44
+ .action(async (_opts, cmd) => {
45
+ const flags = readFlags(cmd);
46
+ await run({
47
+ method: "GET",
48
+ path: "/access-requests/pending",
49
+ output: outputFromFlags(flags),
50
+ profile: flags.profile,
51
+ });
52
+ });
53
+ access
54
+ .command("approve")
55
+ .description("Aprueba una solicitud de acceso. Default scope: task (más seguro).")
56
+ .argument("<request-id>", "id de la solicitud (acr_...)")
57
+ .option("--scope <task|board>", "ámbito del permiso. 'task' sólo expone esta tarea; 'board' expone todo el tablero.", "task")
58
+ .option("--note <text>", "nota opcional para el solicitante")
59
+ .action(async (requestId, opts, cmd) => {
60
+ const flags = readFlags(cmd);
61
+ const scope = opts.scope ?? "task";
62
+ if (scope !== "task" && scope !== "board") {
63
+ throw new Error("--scope debe ser 'task' o 'board'");
64
+ }
65
+ await run({
66
+ method: "POST",
67
+ path: `/access-requests/${encodeURIComponent(requestId)}/resolve`,
68
+ request: {
69
+ body: {
70
+ approve: true,
71
+ resourceScope: scope,
72
+ ...(opts.note ? { note: opts.note } : {}),
73
+ },
74
+ idempotencyKey: flags.idempotencyKey,
75
+ },
76
+ output: outputFromFlags(flags),
77
+ profile: flags.profile,
78
+ asAgent: flags.asAgent,
79
+ });
80
+ });
81
+ access
82
+ .command("deny")
83
+ .description("Rechaza una solicitud de acceso.")
84
+ .argument("<request-id>", "id de la solicitud (acr_...)")
85
+ .option("--note <text>", "nota opcional explicando el rechazo")
86
+ .action(async (requestId, opts, cmd) => {
87
+ const flags = readFlags(cmd);
88
+ await run({
89
+ method: "POST",
90
+ path: `/access-requests/${encodeURIComponent(requestId)}/resolve`,
91
+ request: {
92
+ body: {
93
+ approve: false,
94
+ ...(opts.note ? { note: opts.note } : {}),
95
+ },
96
+ idempotencyKey: flags.idempotencyKey,
97
+ },
98
+ output: outputFromFlags(flags),
99
+ profile: flags.profile,
100
+ asAgent: flags.asAgent,
101
+ });
102
+ });
103
+ }
104
+ //# sourceMappingURL=access.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"access.js","sourceRoot":"","sources":["../../../src/commands/access.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,52 @@
1
+ /**
2
+ * `crm brief` — agent memory primer.
3
+ *
4
+ * Three scopes, picked by which positional + flag the caller passes:
5
+ * - `crm brief <clientId>` client-wide context (profiles, domains, staff)
6
+ * - `crm brief --domain <domainId>` domain context (profile + parent client + open tasks)
7
+ * - `crm brief --task <taskId>` task context (participants + parent domain + cross-refs)
8
+ *
9
+ * Agents call this BEFORE writing anything client- or domain-visible so the
10
+ * assemble-context-before-mention rule (see SKILL.md) holds: the legitimate
11
+ * pool of mentionable members is whoever the brief returns plus task
12
+ * assignees / collaborators (already inlined via `participants`).
13
+ */
14
+ import { run } from "../transport/run.js";
15
+ import { outputFromFlags, readFlags } from "./options.js";
16
+ export function registerBrief(program) {
17
+ program
18
+ .command("brief")
19
+ .description("Resumen de contexto. Pasa un clientId, --domain <id> o --task <id>. Úsalo antes de redactar @menciones / #links.")
20
+ .argument("[clientId]", "id del cliente (opcional si pasas --domain o --task)")
21
+ .option("--domain <id>", "scope a un dominio (perfil + tareas abiertas + cliente padre)")
22
+ .option("--task <id>", "scope a una tarea (participantes + cross-refs + dominio padre)")
23
+ .action(async (clientId, opts, cmd) => {
24
+ const flags = readFlags(cmd);
25
+ const scopeCount = [clientId, opts.domain, opts.task].filter(Boolean).length;
26
+ if (scopeCount === 0) {
27
+ process.stderr.write("[USAGE] crm brief: pasa un clientId, --domain <id> o --task <id>\n");
28
+ process.exit(64);
29
+ }
30
+ if (scopeCount > 1) {
31
+ process.stderr.write("[USAGE] crm brief: pasa solo uno de clientId | --domain | --task\n");
32
+ process.exit(64);
33
+ }
34
+ let path;
35
+ if (opts.task) {
36
+ path = `/brief/task/${encodeURIComponent(opts.task)}`;
37
+ }
38
+ else if (opts.domain) {
39
+ path = `/brief/domain/${encodeURIComponent(opts.domain)}`;
40
+ }
41
+ else {
42
+ path = `/brief/${encodeURIComponent(clientId)}`;
43
+ }
44
+ await run({
45
+ method: "GET",
46
+ path,
47
+ output: outputFromFlags(flags),
48
+ profile: flags.profile,
49
+ });
50
+ });
51
+ }
52
+ //# sourceMappingURL=brief.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"brief.js","sourceRoot":"","sources":["../../../src/commands/brief.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CACV,kHAAkH,CACnH;SACA,QAAQ,CAAC,YAAY,EAAE,sDAAsD,CAAC;SAC9E,MAAM,CAAC,eAAe,EAAE,+DAA+D,CAAC;SACxF,MAAM,CAAC,aAAa,EAAE,gEAAgE,CAAC;SACvF,MAAM,CACL,KAAK,EACH,QAA4B,EAC5B,IAAwC,EACxC,GAAY,EACZ,EAAE;QACF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAC7E,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oEAAoE,CACrE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;QACD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oEAAoE,CACrE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;QAED,IAAI,IAAY,CAAC;QACjB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,GAAG,eAAe,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxD,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,IAAI,GAAG,iBAAiB,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,UAAU,kBAAkB,CAAC,QAAS,CAAC,EAAE,CAAC;QACnD,CAAC;QAED,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,KAAK;YACb,IAAI;YACJ,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACN,CAAC"}
@@ -0,0 +1,203 @@
1
+ /**
2
+ * `crm chat` — list, read, send, reply, react, dm, mark-read, and resolve chat threads.
3
+ *
4
+ * Threads anchor to workspace/client plus explicit DMs/groups (task discussions
5
+ * live in comments). Use `crm chat thread` to resolve or auto-create the
6
+ * canonical thread for a CRM object, then pipe the id into `crm chat send`.
7
+ * For agents that need to start a 1:1 or group conversation, use `crm chat dm`.
8
+ *
9
+ * TID=$(crm chat thread --client cli_xxx --shared --ids-only)
10
+ * crm chat send "$TID" --body "@[Lucía](mid_yyy) revisado"
11
+ * crm chat react <messageId> --emoji "👍"
12
+ * crm chat dm --user user_zzz --body "ping"
13
+ */
14
+ import { run } from "../transport/run.js";
15
+ import { outputFromFlags, readFlags } from "./options.js";
16
+ export function registerChat(program) {
17
+ const chat = program
18
+ .command("chat")
19
+ .description("Chats — conversaciones ancladas a workspace/cliente/dominio + DMs/grupos");
20
+ chat
21
+ .command("list")
22
+ .description("Lista los chats visibles, opcionalmente filtrados por scope")
23
+ .option("--scope <scope>", "workspace | client | dm")
24
+ .option("--client <id>", "sólo hilos de este cliente")
25
+ .action(async (opts, cmd) => {
26
+ const flags = readFlags(cmd);
27
+ await run({
28
+ method: "GET",
29
+ path: "/chats",
30
+ request: {
31
+ query: {
32
+ scope: opts.scope,
33
+ clientId: opts.client,
34
+ },
35
+ },
36
+ output: outputFromFlags(flags),
37
+ profile: flags.profile,
38
+ });
39
+ });
40
+ chat
41
+ .command("read")
42
+ .description("Devuelve los últimos mensajes de un chat (ascendente por fecha)")
43
+ .argument("<threadId>", "id del hilo")
44
+ .option("--page-limit <n>", "tamaño de página (por defecto 50)", (v) => parseInt(v, 10))
45
+ .option("--before <ms>", "epoch ms — sólo mensajes anteriores", (v) => parseInt(v, 10))
46
+ .action(async (threadId, opts, cmd) => {
47
+ const flags = readFlags(cmd);
48
+ await run({
49
+ method: "GET",
50
+ path: `/chats/${encodeURIComponent(threadId)}/messages`,
51
+ request: {
52
+ query: {
53
+ limit: opts.pageLimit,
54
+ before: opts.before,
55
+ },
56
+ },
57
+ output: outputFromFlags(flags),
58
+ profile: flags.profile,
59
+ });
60
+ });
61
+ chat
62
+ .command("thread")
63
+ .description("Resuelve (o crea) el hilo canónico de un objeto. Idempotente — útil para piping con `chat send`.")
64
+ .option("--workspace", "hilo de workspace (sólo staff, siempre interno)")
65
+ .option("--client <id>", "hilo de este cliente")
66
+ .option("--shared", "usa el hilo compartido con cliente (default: interno staff-only)")
67
+ .action(async (opts, cmd) => {
68
+ const flags = readFlags(cmd);
69
+ const clientVisible = opts.shared === true;
70
+ let body;
71
+ if (opts.client) {
72
+ body = { scope: "client", clientVisible, clientId: opts.client };
73
+ }
74
+ else if (opts.workspace) {
75
+ body = { scope: "workspace", clientVisible: false };
76
+ }
77
+ else {
78
+ throw new Error("Especifica uno de --client / --workspace.");
79
+ }
80
+ await run({
81
+ method: "POST",
82
+ path: "/chats",
83
+ request: {
84
+ body,
85
+ idempotencyKey: flags.idempotencyKey,
86
+ },
87
+ output: outputFromFlags(flags),
88
+ profile: flags.profile,
89
+ });
90
+ });
91
+ chat
92
+ .command("send")
93
+ .description("Envía un mensaje a un hilo existente")
94
+ .argument("<threadId>", "id del hilo (usa `crm chat thread` para resolverlo)")
95
+ .requiredOption("--body <text>", "contenido del mensaje (markdown + @menciones)")
96
+ .option("--kind <kind>", "message | agent_log (los agentes usan agent_log por defecto)")
97
+ .option("--parent <messageId>", "id del mensaje padre — convierte el envío en respuesta a un hilo")
98
+ .action(async (threadId, opts, cmd) => {
99
+ const flags = readFlags(cmd);
100
+ await run({
101
+ method: "POST",
102
+ path: `/chats/${encodeURIComponent(threadId)}/messages`,
103
+ request: {
104
+ body: {
105
+ content: opts.body,
106
+ kind: opts.kind,
107
+ parentMessageId: opts.parent,
108
+ },
109
+ idempotencyKey: flags.idempotencyKey,
110
+ },
111
+ output: outputFromFlags(flags),
112
+ profile: flags.profile,
113
+ asAgent: flags.asAgent,
114
+ });
115
+ });
116
+ chat
117
+ .command("reply")
118
+ .description("Atajo para responder a un mensaje (alias de `chat send` con --parent rellenado)")
119
+ .argument("<messageId>", "id del mensaje al que responder")
120
+ .requiredOption("--body <text>", "contenido de la respuesta (markdown + @menciones)")
121
+ .requiredOption("--thread <id>", "id del hilo donde vive el mensaje")
122
+ .option("--kind <kind>", "message | agent_log")
123
+ .action(async (messageId, opts, cmd) => {
124
+ const flags = readFlags(cmd);
125
+ await run({
126
+ method: "POST",
127
+ path: `/chats/${encodeURIComponent(opts.thread)}/messages`,
128
+ request: {
129
+ body: {
130
+ content: opts.body,
131
+ kind: opts.kind,
132
+ parentMessageId: messageId,
133
+ },
134
+ idempotencyKey: flags.idempotencyKey,
135
+ },
136
+ output: outputFromFlags(flags),
137
+ profile: flags.profile,
138
+ asAgent: flags.asAgent,
139
+ });
140
+ });
141
+ chat
142
+ .command("react")
143
+ .description("Activa o desactiva una reacción en un mensaje (👍 ✅ 👀 🙏 ❤️ ❓ 🔥 🚀)")
144
+ .argument("<messageId>", "id del mensaje")
145
+ .requiredOption("--emoji <emoji>", "emoji curado (uno de los 8 permitidos)")
146
+ .action(async (messageId, opts, cmd) => {
147
+ const flags = readFlags(cmd);
148
+ await run({
149
+ method: "POST",
150
+ path: `/chats/messages/${encodeURIComponent(messageId)}/reactions`,
151
+ request: {
152
+ body: { emoji: opts.emoji },
153
+ idempotencyKey: flags.idempotencyKey,
154
+ },
155
+ output: outputFromFlags(flags),
156
+ profile: flags.profile,
157
+ asAgent: flags.asAgent,
158
+ });
159
+ });
160
+ chat
161
+ .command("dm")
162
+ .description("Crea un DM 1:1 o grupo personalizado. Idempotente para 1:1 (mismos miembros → mismo hilo).")
163
+ .requiredOption("--member <id...>", "ids de miembro o usuario (acepta varios con --member id1 --member id2)")
164
+ .option("--title <name>", "nombre opcional para grupos")
165
+ .option("--client <id>", "ancla el grupo a este cliente (necesario si incluye un cliente)")
166
+ .action(async (opts, cmd) => {
167
+ const flags = readFlags(cmd);
168
+ await run({
169
+ method: "POST",
170
+ path: "/chats/dm",
171
+ request: {
172
+ body: {
173
+ memberIds: opts.member,
174
+ title: opts.title,
175
+ parentClientId: opts.client,
176
+ },
177
+ idempotencyKey: flags.idempotencyKey,
178
+ },
179
+ output: outputFromFlags(flags),
180
+ profile: flags.profile,
181
+ asAgent: flags.asAgent,
182
+ });
183
+ });
184
+ chat
185
+ .command("mark-read")
186
+ .description("Marca un chat como leído (avanza el cursor de lectura)")
187
+ .argument("<threadId>", "id del hilo")
188
+ .option("--message <id>", "última message id leída (opcional)")
189
+ .action(async (threadId, opts, cmd) => {
190
+ const flags = readFlags(cmd);
191
+ await run({
192
+ method: "POST",
193
+ path: `/chats/${encodeURIComponent(threadId)}/read`,
194
+ request: {
195
+ body: { lastReadMessageId: opts.message },
196
+ idempotencyKey: flags.idempotencyKey,
197
+ },
198
+ output: outputFromFlags(flags),
199
+ profile: flags.profile,
200
+ });
201
+ });
202
+ }
203
+ //# sourceMappingURL=chat.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/commands/chat.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,89 @@
1
+ /**
2
+ * `crm commands` — dump the full CLI surface as a JSON catalog so agents can
3
+ * introspect commands without hitting the API. SKILL.md promises this as the
4
+ * "v2 escape hatch"; this is that.
5
+ *
6
+ * Output shape is a tree of {name, description, args, options, subcommands}.
7
+ * Every node mirrors the commander Command — names are the resolved
8
+ * subcommand chain (e.g. "task create"), descriptions are the Spanish strings
9
+ * already on each command. Options preserve flags, required-ness, and the
10
+ * description verbatim.
11
+ */
12
+ import { renderSuccess } from "../transport/envelope.js";
13
+ import { outputFromFlags, readFlags } from "./options.js";
14
+ /** Describe one option without leaking commander internals to callers. */
15
+ function describeOption(opt) {
16
+ return {
17
+ flags: opt.flags,
18
+ description: opt.description ?? "",
19
+ required: opt.required ?? false,
20
+ isBoolean: !opt.flags.includes("<") && !opt.flags.includes("["),
21
+ isNegated: opt.negate === true,
22
+ defaultValue: opt.defaultValue,
23
+ };
24
+ }
25
+ function describeArg(arg) {
26
+ return {
27
+ name: arg.name(),
28
+ description: arg.description ?? "",
29
+ required: arg.required,
30
+ variadic: arg.variadic,
31
+ };
32
+ }
33
+ /** Walk the commander tree producing the catalog. The root command (the
34
+ * `program` itself) gets dropped — we only emit user-facing verbs. */
35
+ function walk(cmd, parentPath) {
36
+ const out = [];
37
+ for (const child of cmd.commands) {
38
+ // Skip the auto-generated help command.
39
+ if (child.name() === "help")
40
+ continue;
41
+ const path = parentPath ? `${parentPath} ${child.name()}` : child.name();
42
+ out.push({
43
+ path,
44
+ name: child.name(),
45
+ description: child.description() ?? "",
46
+ args: (child.registeredArguments ?? []).map(describeArg),
47
+ options: child.options.map(describeOption),
48
+ subcommands: walk(child, path),
49
+ });
50
+ }
51
+ return out;
52
+ }
53
+ export function registerCommands(program) {
54
+ program
55
+ .command("commands")
56
+ .description("Dump del catálogo completo del CLI como JSON (verbos, args, flags). Útil para introspección de agentes.")
57
+ .action((_opts, cmd) => {
58
+ const flags = readFlags(cmd);
59
+ // Walk from the program root so we get every top-level verb.
60
+ const root = cmd.parent ?? cmd;
61
+ const tree = walk(root, "");
62
+ // Flat index by path — agents can `--jq .data.flat[]` to iterate.
63
+ const flat = [];
64
+ const pushFlat = (n) => {
65
+ flat.push({
66
+ path: n.path,
67
+ name: n.name,
68
+ description: n.description,
69
+ args: n.args,
70
+ options: n.options,
71
+ });
72
+ for (const sub of n.subcommands)
73
+ pushFlat(sub);
74
+ };
75
+ for (const n of tree)
76
+ pushFlat(n);
77
+ const envelope = {
78
+ ok: true,
79
+ data: { tree, flat },
80
+ summary: `${flat.length} comando(s) registrados`,
81
+ meta: {
82
+ requestId: `commands_${Date.now()}`,
83
+ timestamp: new Date().toISOString(),
84
+ },
85
+ };
86
+ renderSuccess(envelope, outputFromFlags(flags));
87
+ });
88
+ }
89
+ //# sourceMappingURL=commands.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/commands/commands.ts"],"names":[],"mappings":"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"}
@@ -39,6 +39,7 @@ export function registerComment(program) {
39
39
  profile: flags.profile,
40
40
  waitForApproval: flags.waitForApproval,
41
41
  waitTimeoutMs: parseDurationMs(flags.timeout),
42
+ asAgent: flags.asAgent,
42
43
  });
43
44
  });
44
45
  }
@@ -1 +1 @@
1
- {"version":3,"file":"comment.js","sourceRoot":"","sources":["../../../src/commands/comment.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAGxD,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAE/E,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,oCAAoC,CAAC;SACjD,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;SACnC,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,WAAW;YACrD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,mEAAmE,CAAC;SAChF,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC;SAC5C,cAAc,CAAC,eAAe,EAAE,gEAAgE,CAAC;SACjG,MAAM,CACL,eAAe,EACf,sEAAsE,CACvE;SACA,MAAM,CACL,KAAK,EACH,IAA8E,EAC9E,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,IAAI,CAAC,IAAI,CAAC,WAAW;YACxD,OAAO,EAAE;gBACP,IAAI,EAAE;oBACJ,OAAO,EAAE,IAAI,CAAC,IAAI;oBAClB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1C;gBACD,cAAc,EAAE,KAAK,CAAC,cAAc;aACrC;YACD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACN,CAAC"}
1
+ {"version":3,"file":"comment.js","sourceRoot":"","sources":["../../../src/commands/comment.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAGxD,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAE/E,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,oCAAoC,CAAC;SACjD,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;SACnC,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,WAAW;YACrD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,mEAAmE,CAAC;SAChF,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC;SAC5C,cAAc,CAAC,eAAe,EAAE,gEAAgE,CAAC;SACjG,MAAM,CACL,eAAe,EACf,sEAAsE,CACvE;SACA,MAAM,CACL,KAAK,EACH,IAA8E,EAC9E,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,IAAI,CAAC,IAAI,CAAC,WAAW;YACxD,OAAO,EAAE;gBACP,IAAI,EAAE;oBACJ,OAAO,EAAE,IAAI,CAAC,IAAI;oBAClB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1C;gBACD,cAAc,EAAE,KAAK,CAAC,cAAc;aACrC;YACD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC;YAC7C,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACN,CAAC"}