@roilab/crm-cli 0.12.0 → 0.15.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/SURFACE.txt CHANGED
@@ -19,7 +19,9 @@ CMD crm auth list
19
19
  CMD crm auth switch <name>
20
20
  CMD crm auth logout [name]
21
21
 
22
- CMD crm task list --status <status> --domain <id> --assignee <id> --tag <id> --limit <n>
22
+ CMD crm task list --status <status> --domain <id> --board <id> --column <id> --assignee <id> --tag <id> --limit <n>
23
+ # --board filtra al tablero primario; --column a una columna kanban. Combínalos
24
+ # para leer una sola swimlane (p. ej. el backlog "To Do" de un board de redactores).
23
25
  CMD crm task get <id>
24
26
  # task get returns `participants[]` with name, role, expertise, and
25
27
  # internalNotes (staff-only, markdown handling rules) — use it instead of a
@@ -35,14 +37,21 @@ CMD crm task search <query> --limit <n>
35
37
  CMD crm task preflight --title <title> --url <url> --domain <id> --limit <n> --since-ms <epoch>
36
38
  # task create / update accept the full mutation surface: `--assignee` (responsible)
37
39
  # vs `--collaborator` (follower); `--start` + `--due`; `--completion-strategy`
38
- # (all|any|manual); `--board` (move to another board on update). `task update`
39
- # uses `--client-visible` / `--no-client-visible` (symmetric boolean flags).
40
+ # (all|any|manual); `--board` (move to another board on update); `--column`
41
+ # (place the task in a kanban column on its board — adopts the column status and
42
+ # applies its auto-assign, e.g. drops a redactor into their swimlane). `task
43
+ # update` uses `--client-visible` / `--no-client-visible` (symmetric boolean flags).
40
44
  # `--file <path>` (repetible) adjunta archivos a la tarea. Máx 10 MB cada uno;
41
45
  # el CLI avisa en stderr a partir de 2 MB y rechaza localmente >10 MB antes de
42
46
  # tocar la red. En `task update` la lista es REEMPLAZO (los adjuntos antiguos
43
47
  # se borran salvo que también los pases); usa `--clear-files` para vaciar.
44
48
  CMD crm task create --title <title> --description <text> --domain <id> --board <id> --status <status> --assignee <id...> --collaborator <id...> --tag <id...> --start <date> --due <date> --completion-strategy <all|any|manual> --client-visible --no-review --file <path...>
45
- CMD crm task update <id> --title <title> --status <status> --domain <id> --board <id> --assignee <id...> --collaborator <id...> --tag <id...> --start <date> --due <date> --completion-strategy <all|any|manual> --client-visible --no-client-visible --file <path...> --clear-files
49
+ CMD crm task update <id> --title <title> --status <status> --domain <id> --board <id> --column <id> --assignee <id...> --collaborator <id...> --tag <id...> --start <date> --due <date> --completion-strategy <all|any|manual> --client-visible --no-client-visible --file <path...> --clear-files
50
+ # Tableros kanban — `board columns <boardId>` lista las columnas (ordenadas) con
51
+ # su autoAssignUserId / autoMoveOnAssign. Flujo redactores: `board columns` para
52
+ # resolver la columna de cada redactor → `task update <id> --column <colId>`
53
+ # (la auto-asignación coloca al redactor y la tarjeta cae en su columna).
54
+ CMD crm board columns <boardId>
46
55
  # Phase 41 — task ↔ backlink linking. `assets` returns the primary FK +
47
56
  # outgoing mentions in one payload; `link-backlink` / `link-offer` set the
48
57
  # primary FK (use --unlink to clear); `complete-with-evidence` closes a task
@@ -101,6 +110,8 @@ CMD crm domain profile-set <id> --positioning <text> --tone-override <text> --au
101
110
  # account, GBP location). Si pasas --account + source ingestible (gsc/ga4/bing)
102
111
  # se programa una ingesta inmediata de hasta 16 meses. Owner/admin only.
103
112
  CMD crm property create --source-type <gsc|ga4|bing|ads|gbp> --identifier <id> --display-name <name> --client <id> --domain <id> --account <id> --backfill <date> --favicon <url> --currency <code> --website-url <url>
113
+ # update: campos omitidos no cambian; --clear-client / --clear-domain desvinculan.
114
+ CMD crm property update <id> --display-name <name> --client <id> --clear-client --domain <id> --clear-domain --favicon <url> --primary-metric <id>
104
115
 
105
116
  CMD crm backlink list --domain <id> --status <status>
106
117
  CMD crm backlink lost --domain <id> --since <iso>
@@ -117,6 +128,9 @@ CMD crm backlink rejection-report --domain <id> --client <id> --since-days <n>
117
128
  CMD crm backlink set-status <id> --status <pending_check|active|nofollowed|anchor_changed|removed|broken|redirected|deindexed|blocked|non_crawlable|manual_override> --note <text>
118
129
  # Edita la URL de origen (subpagina equivocada) → recalcula + resetea salud + re-check.
119
130
  CMD crm backlink update <id> --source-url <url>
131
+ # Cruza sospechosos vs Ahrefs (oráculo independiente). NO cambia estados.
132
+ # Dry-run por defecto; --confirm gasta unidades (1 llamada filtrada, aborta si pocas).
133
+ CMD crm backlink reconcile --domain <id> --confirm --unit-floor <n>
120
134
 
121
135
  CMD crm offer list-tasks <offer-id>
122
136
 
@@ -191,13 +205,22 @@ CMD crm integration list
191
205
  CMD crm integration sites --account <id> --service <gsc|ga4|bing>
192
206
  CMD crm integration sync --property <id>
193
207
 
194
- # gsc/ga4/bing query hit the live provider API (tokens stay on server).
208
+ # gsc/ga4/bing/ads query hit the live provider API (tokens stay on server).
195
209
  # --filters is ';'-separated. Format: "<dim> <op> <expr>; ..."
196
210
  # Operators (GSC + Bing): equals | contains | regex | not_equals | not_contains | not_regex
197
211
  # Operators (GA4 adds): batch (inListFilter; value is newline-separated)
212
+ # ads query is read-only GAQL; cost is returned in micros (÷1e6 for currency).
198
213
  CMD crm gsc query --property <id> --account <id> --site-url <url> --start <date> --end <date> --dimension <date|page|query|country|device> --filters <expr> --cursor <n>
199
214
  CMD crm ga4 query --property <id> --account <id> --ga4-property <num> --start <date> --end <date> --filters <expr>
200
215
  CMD crm bing query --property <id> --account <id> --site-url <url> --start <date> --end <date>
216
+ CMD crm ads query --property <id> --account <id> --customer-id <id> --start <date> --end <date>
217
+ CMD crm ads whoami --account <id> # diagnóstico OAuth: scopes concedidos + ¿'adwords'? + MCC/dev-token
218
+ CMD crm ads accounts --account <id> # enumera cuentas hijas del MCC (customerId/nombre/moneda)
219
+ CMD crm ads campaigns --property <id> --account <id> --customer-id <id> --start <date> --end <date> --compare-start <date> --compare-end <date> # desglose por campaña + CPA/ROAS + deltas
220
+ CMD crm ads anomalies --property <id> --start <date> --end <date> --compare-start <date> --compare-end <date> # pico CPA/caída ROAS/gasto disparado/0-conv por cuenta (omite --property = todas)
221
+ CMD crm ads pacing --property <id> --month-start <date> --as-of <date> # gasto MTD vs presupuesto + proyección (omite --property = todas)
222
+ CMD crm ads budget --property <id> --set <amount> --clear # sin --set/--clear lee; --set fija; --clear elimina
223
+ CMD crm ads import # dispara ingesta fresca de Google Ads (diaria + campañas) del workspace
201
224
 
202
225
  # Agency skills — librería de playbooks para Claude Code. `pull` escribe en
203
226
  # `.claude/skills/<slug>/SKILL.md` + recursos; el manifest se guarda en
@@ -217,6 +240,20 @@ CMD crm skill pull --all --category <name> --tag <id>
217
240
  CMD crm skill update --dry-run
218
241
  CMD crm skill diff <slug>
219
242
 
243
+ # Documentos de trabajo de cliente — procesos en markdown editables por IA.
244
+ # Anclados a un cliente; internos por defecto, opt-in a cliente con `share`.
245
+ # Cuerpos largos/markdown SIEMPRE por `--body-file` (no `--body "$(cat)"`).
246
+ CMD crm doc list --client <id> --kind <proceso|guia|nota|entregable> --status <draft|published|archived> --q <text>
247
+ CMD crm doc get <slug> --client <id>
248
+ CMD crm doc content <slug> --client <id> --revision <id>
249
+ CMD crm doc revisions <slug> --client <id>
250
+ CMD crm doc create --client <id> --slug <slug> --title <text> --summary <text> --kind <proceso|guia|nota|entregable> --domain <id> --body <md> --body-file <path>
251
+ CMD crm doc update <slug> --client <id> --title <text> --summary <text> --kind <kind> --domain <id> --body <md> --body-file <path>
252
+ CMD crm doc publish <slug> --client <id> --note <text>
253
+ CMD crm doc share <slug> --client <id> --retract
254
+ CMD crm doc archive <slug> --client <id>
255
+ CMD crm doc restore <slug> --client <id>
256
+
220
257
  CMD crm time log --task <id> --description <text> --date <YYYY-MM-DD> --started-at <epoch|iso> --ended-at <epoch|iso> --duration <minutes>
221
258
  CMD crm time list --from <YYYY-MM-DD> --to <YYYY-MM-DD> --user <id>
222
259
  # Entries linked to a specific task (no date filter).
package/dist/bin/crm.js CHANGED
@@ -11,6 +11,7 @@ import { registerAccess } from "../src/commands/access.js";
11
11
  import { registerAuth } from "../src/commands/auth.js";
12
12
  import { registerCommands } from "../src/commands/commands.js";
13
13
  import { registerTask } from "../src/commands/task.js";
14
+ import { registerBoard } from "../src/commands/board.js";
14
15
  import { registerComment } from "../src/commands/comment.js";
15
16
  import { registerChat } from "../src/commands/chat.js";
16
17
  import { registerGeneric } from "../src/commands/generic.js";
@@ -18,6 +19,7 @@ import { registerDoctor } from "../src/commands/doctor.js";
18
19
  import { registerReview } from "../src/commands/review.js";
19
20
  import { registerIntegrations } from "../src/commands/integrations.js";
20
21
  import { registerSkill } from "../src/commands/skill.js";
22
+ import { registerDoc } from "../src/commands/doc.js";
21
23
  import { registerBrief } from "../src/commands/brief.js";
22
24
  import { registerMention } from "../src/commands/mention.js";
23
25
  import { registerTime } from "../src/commands/time.js";
@@ -37,6 +39,7 @@ registerGlobalFlags(program);
37
39
  registerAuth(program);
38
40
  registerAccess(program);
39
41
  registerTask(program);
42
+ registerBoard(program);
40
43
  registerComment(program);
41
44
  registerChat(program);
42
45
  registerGeneric(program);
@@ -45,6 +48,7 @@ registerMention(program);
45
48
  registerReview(program);
46
49
  registerIntegrations(program);
47
50
  registerSkill(program);
51
+ registerDoc(program);
48
52
  registerTime(program);
49
53
  registerRank(program);
50
54
  registerMeta(program);
@@ -1 +1 @@
1
- {"version":3,"file":"crm.js","sourceRoot":"","sources":["../../bin/crm.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"crm.js","sourceRoot":"","sources":["../../bin/crm.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ /** `crm board` — introspección de tableros kanban (columnas + auto-asignación). */
2
+ import { run } from "../transport/run.js";
3
+ import { outputFromFlags, readFlags } from "./options.js";
4
+ export function registerBoard(program) {
5
+ const board = program
6
+ .command("board")
7
+ .description("Tableros kanban — columnas y configuración de auto-asignación");
8
+ board
9
+ .command("columns")
10
+ .description("Lista las columnas de un tablero (ordenadas) con su autoAssignUserId / autoMoveOnAssign. Úsalo para resolver qué columna auto-asigna a qué redactor antes de colocar tareas con `crm task update <id> --column <colId>`.")
11
+ .argument("<boardId>", "id del tablero (board)")
12
+ .action(async (boardId, _opts, cmd) => {
13
+ const flags = readFlags(cmd);
14
+ await run({
15
+ method: "GET",
16
+ path: `/boards/${encodeURIComponent(boardId)}/columns`,
17
+ output: outputFromFlags(flags),
18
+ profile: flags.profile,
19
+ });
20
+ });
21
+ }
22
+ //# sourceMappingURL=board.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"board.js","sourceRoot":"","sources":["../../../src/commands/board.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAGnF,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,KAAK,GAAG,OAAO;SAClB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,+DAA+D,CAAC,CAAC;IAEhF,KAAK;SACF,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CACV,0NAA0N,CAC3N;SACA,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,KAAK,EAAE,GAAY,EAAE,EAAE;QACrD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,WAAW,kBAAkB,CAAC,OAAO,CAAC,UAAU;YACtD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}
@@ -0,0 +1,267 @@
1
+ /**
2
+ * `crm doc` — client work documents (Phase 45).
3
+ *
4
+ * Per-client markdown process docs ("cómo descatalogar un producto", "criterio
5
+ * index/noindex en altas"). Unlike `crm skill` there is NO on-disk mirror —
6
+ * agents read/write the markdown body directly over the API. Long or
7
+ * code-fenced bodies go through `--body-file` to dodge the shell
8
+ * command-substitution truncation bug (see [[cli_comment_body_multiline_truncates]]).
9
+ *
10
+ * crm doc list --client <id> [--kind ...] [--status ...] [--q ...]
11
+ * crm doc get <slug> --client <id>
12
+ * crm doc content <slug> --client <id> [--revision <id>]
13
+ * crm doc revisions <slug> --client <id>
14
+ * crm doc create --client <id> --slug <s> --title <t> --summary <s> --kind <k> [--domain <id>] [--body-file <p>]
15
+ * crm doc update <slug> --client <id> [--title ...] [--summary ...] [--body-file <p>]
16
+ * crm doc publish <slug> --client <id> --note "<changeSummary>"
17
+ * crm doc share <slug> --client <id> [--retract]
18
+ * crm doc archive | restore <slug> --client <id>
19
+ */
20
+ import { readFileSync } from "node:fs";
21
+ import { run } from "../transport/run.js";
22
+ import { outputFromFlags, readFlags } from "./options.js";
23
+ const DOC_KINDS = ["proceso", "guia", "nota", "entregable"];
24
+ /** Resolve a markdown body from `--body` or `--body-file` (mutually exclusive). */
25
+ function resolveBody(inline, filePath) {
26
+ if (inline !== undefined && filePath !== undefined) {
27
+ process.stderr.write("error: --body y --body-file son mutuamente excluyentes\n");
28
+ process.exit(2);
29
+ }
30
+ if (filePath === undefined)
31
+ return inline;
32
+ try {
33
+ return readFileSync(filePath, "utf8");
34
+ }
35
+ catch (err) {
36
+ const msg = err instanceof Error ? err.message : String(err);
37
+ process.stderr.write(`error: no se pudo leer --body-file: ${msg}\n`);
38
+ process.exit(2);
39
+ }
40
+ }
41
+ function assertKind(kind) {
42
+ if (kind !== undefined && !DOC_KINDS.includes(kind)) {
43
+ process.stderr.write(`error: --kind debe ser uno de ${DOC_KINDS.join(", ")}\n`);
44
+ process.exit(2);
45
+ }
46
+ }
47
+ export function registerDoc(program) {
48
+ const doc = program
49
+ .command("doc")
50
+ .description("Documentos de trabajo de cliente — procesos en markdown editables por IA");
51
+ // ── list
52
+ doc
53
+ .command("list")
54
+ .description("Lista los documentos de un cliente")
55
+ .requiredOption("--client <id>", "id del cliente")
56
+ .option("--kind <kind>", `filtra por tipo: ${DOC_KINDS.join(" | ")}`)
57
+ .option("--status <name>", "draft | published | archived")
58
+ .option("--q <text>", "búsqueda libre sobre el resumen")
59
+ .action(async (opts, cmd) => {
60
+ assertKind(opts.kind);
61
+ const flags = readFlags(cmd);
62
+ await run({
63
+ method: "GET",
64
+ path: `/clients/${encodeURIComponent(opts.client)}/docs`,
65
+ request: {
66
+ query: { kind: opts.kind, status: opts.status, q: opts.q, limit: flags.limit },
67
+ },
68
+ output: outputFromFlags(flags),
69
+ profile: flags.profile,
70
+ });
71
+ });
72
+ // ── get (metadata + draft pointer)
73
+ doc
74
+ .command("get")
75
+ .description("Metadatos de un documento (incluye el draft y el puntero a la última revisión)")
76
+ .argument("<slug>")
77
+ .requiredOption("--client <id>", "id del cliente")
78
+ .action(async (slug, opts, cmd) => {
79
+ const flags = readFlags(cmd);
80
+ await run({
81
+ method: "GET",
82
+ path: `/clients/${encodeURIComponent(opts.client)}/docs/${encodeURIComponent(slug)}`,
83
+ output: outputFromFlags(flags),
84
+ profile: flags.profile,
85
+ });
86
+ });
87
+ // ── content (published markdown body)
88
+ doc
89
+ .command("content")
90
+ .description("Cuerpo markdown publicado del documento")
91
+ .argument("<slug>")
92
+ .requiredOption("--client <id>", "id del cliente")
93
+ .option("--revision <id>", "revisión específica (default: última publicada)")
94
+ .action(async (slug, opts, cmd) => {
95
+ const flags = readFlags(cmd);
96
+ const q = opts.revision ? `?revisionId=${encodeURIComponent(opts.revision)}` : "";
97
+ await run({
98
+ method: "GET",
99
+ path: `/clients/${encodeURIComponent(opts.client)}/docs/${encodeURIComponent(slug)}/content${q}`,
100
+ output: outputFromFlags(flags),
101
+ profile: flags.profile,
102
+ });
103
+ });
104
+ // ── revisions (history)
105
+ doc
106
+ .command("revisions")
107
+ .description("Historial de revisiones publicadas del documento")
108
+ .argument("<slug>")
109
+ .requiredOption("--client <id>", "id del cliente")
110
+ .action(async (slug, opts, cmd) => {
111
+ const flags = readFlags(cmd);
112
+ await run({
113
+ method: "GET",
114
+ path: `/clients/${encodeURIComponent(opts.client)}/docs/${encodeURIComponent(slug)}/revisions`,
115
+ request: { query: { limit: flags.limit } },
116
+ output: outputFromFlags(flags),
117
+ profile: flags.profile,
118
+ });
119
+ });
120
+ // ── create
121
+ doc
122
+ .command("create")
123
+ .description("Crea un documento en estado draft (interno por defecto). Publica con `crm doc publish`.")
124
+ .requiredOption("--client <id>", "id del cliente")
125
+ .requiredOption("--slug <slug>", "identificador lowercase-hyphen, único por cliente (3-64 chars)")
126
+ .requiredOption("--title <text>", "título visible")
127
+ .requiredOption("--summary <text>", "resumen de una línea (≤1024 chars)")
128
+ .requiredOption("--kind <kind>", `tipo: ${DOC_KINDS.join(" | ")}`)
129
+ .option("--domain <id>", "ancla opcional a un dominio del cliente")
130
+ .option("--body <text>", "cuerpo inicial (markdown)")
131
+ .option("--body-file <path>", "lee el cuerpo inicial desde un archivo (recomendado para markdown largo)")
132
+ .action(async (opts, cmd) => {
133
+ assertKind(opts.kind);
134
+ const flags = readFlags(cmd);
135
+ const initialBody = resolveBody(opts.body, opts.bodyFile);
136
+ await run({
137
+ method: "POST",
138
+ path: `/clients/${encodeURIComponent(opts.client)}/docs`,
139
+ request: {
140
+ body: {
141
+ slug: opts.slug,
142
+ title: opts.title,
143
+ summary: opts.summary,
144
+ kind: opts.kind,
145
+ domainId: opts.domain,
146
+ initialBody,
147
+ },
148
+ idempotencyKey: flags.idempotencyKey,
149
+ },
150
+ output: outputFromFlags(flags),
151
+ profile: flags.profile,
152
+ asAgent: flags.asAgent,
153
+ });
154
+ });
155
+ // ── update (draft)
156
+ doc
157
+ .command("update")
158
+ .description("Edita el draft de un documento (metadatos y/o cuerpo markdown).")
159
+ .argument("<slug>")
160
+ .requiredOption("--client <id>", "id del cliente")
161
+ .option("--title <text>", "nuevo título")
162
+ .option("--summary <text>", "nuevo resumen (≤1024 chars)")
163
+ .option("--kind <kind>", `tipo: ${DOC_KINDS.join(" | ")}`)
164
+ .option("--domain <id>", "ancla a un dominio del cliente")
165
+ .option("--body <text>", "nuevo cuerpo (markdown)")
166
+ .option("--body-file <path>", "lee el cuerpo desde un archivo")
167
+ .action(async (slug, opts, cmd) => {
168
+ assertKind(opts.kind);
169
+ const flags = readFlags(cmd);
170
+ const draftBody = resolveBody(opts.body, opts.bodyFile);
171
+ await run({
172
+ method: "PATCH",
173
+ path: `/clients/${encodeURIComponent(opts.client)}/docs/${encodeURIComponent(slug)}`,
174
+ request: {
175
+ body: {
176
+ title: opts.title,
177
+ summary: opts.summary,
178
+ kind: opts.kind,
179
+ domainId: opts.domain,
180
+ draftBody,
181
+ },
182
+ idempotencyKey: flags.idempotencyKey,
183
+ },
184
+ output: outputFromFlags(flags),
185
+ profile: flags.profile,
186
+ asAgent: flags.asAgent,
187
+ });
188
+ });
189
+ // ── publish
190
+ doc
191
+ .command("publish")
192
+ .description("Publica el draft como una nueva revisión inmutable (requiere rol owner/admin).")
193
+ .argument("<slug>")
194
+ .requiredOption("--client <id>", "id del cliente")
195
+ .requiredOption("--note <text>", "resumen del cambio (≤200 chars)")
196
+ .action(async (slug, opts, cmd) => {
197
+ const flags = readFlags(cmd);
198
+ if (opts.note.length > 200) {
199
+ process.stderr.write("--note debe tener 200 caracteres o menos.\n");
200
+ process.exit(2);
201
+ }
202
+ await run({
203
+ method: "POST",
204
+ path: `/clients/${encodeURIComponent(opts.client)}/docs/${encodeURIComponent(slug)}/publish`,
205
+ request: { body: { changeSummary: opts.note }, idempotencyKey: flags.idempotencyKey },
206
+ output: outputFromFlags(flags),
207
+ profile: flags.profile,
208
+ asAgent: flags.asAgent,
209
+ });
210
+ });
211
+ // ── share (client visibility opt-in)
212
+ doc
213
+ .command("share")
214
+ .description("Marca el documento como visible al cliente. Como agente, queda oculto hasta que staff acepte la revisión. Usa --retract para quitar la exposición.")
215
+ .argument("<slug>")
216
+ .requiredOption("--client <id>", "id del cliente")
217
+ .option("--retract", "retira la exposición al cliente (visible:false)")
218
+ .action(async (slug, opts, cmd) => {
219
+ const flags = readFlags(cmd);
220
+ await run({
221
+ method: "POST",
222
+ path: `/clients/${encodeURIComponent(opts.client)}/docs/${encodeURIComponent(slug)}/share`,
223
+ request: {
224
+ body: { visible: opts.retract !== true },
225
+ idempotencyKey: flags.idempotencyKey,
226
+ },
227
+ output: outputFromFlags(flags),
228
+ profile: flags.profile,
229
+ asAgent: flags.asAgent,
230
+ });
231
+ });
232
+ // ── archive
233
+ doc
234
+ .command("archive")
235
+ .description("Archiva un documento (oculto de la lista; revisiones siguen accesibles).")
236
+ .argument("<slug>")
237
+ .requiredOption("--client <id>", "id del cliente")
238
+ .action(async (slug, opts, cmd) => {
239
+ const flags = readFlags(cmd);
240
+ await run({
241
+ method: "POST",
242
+ path: `/clients/${encodeURIComponent(opts.client)}/docs/${encodeURIComponent(slug)}/archive`,
243
+ request: { body: {}, idempotencyKey: flags.idempotencyKey },
244
+ output: outputFromFlags(flags),
245
+ profile: flags.profile,
246
+ asAgent: flags.asAgent,
247
+ });
248
+ });
249
+ // ── restore
250
+ doc
251
+ .command("restore")
252
+ .description("Restaura un documento archivado.")
253
+ .argument("<slug>")
254
+ .requiredOption("--client <id>", "id del cliente")
255
+ .action(async (slug, opts, cmd) => {
256
+ const flags = readFlags(cmd);
257
+ await run({
258
+ method: "POST",
259
+ path: `/clients/${encodeURIComponent(opts.client)}/docs/${encodeURIComponent(slug)}/restore`,
260
+ request: { body: {}, idempotencyKey: flags.idempotencyKey },
261
+ output: outputFromFlags(flags),
262
+ profile: flags.profile,
263
+ asAgent: flags.asAgent,
264
+ });
265
+ });
266
+ }
267
+ //# sourceMappingURL=doc.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"doc.js","sourceRoot":"","sources":["../../../src/commands/doc.ts"],"names":[],"mappings":"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"}
@@ -146,6 +146,45 @@ export function registerGeneric(program) {
146
146
  asAgent: flags.asAgent,
147
147
  });
148
148
  });
149
+ property
150
+ .command("update")
151
+ .description("Actualiza una property: vincúlala a su dominio/cliente, renómbrala u ocúltala. Los campos omitidos no cambian.")
152
+ .argument("<id>", "id de la property (prop_...)")
153
+ .option("--display-name <name>", "nombre legible")
154
+ .option("--client <id>", "id del cliente al que pertenece")
155
+ .option("--clear-client", "desvincula la property de su cliente")
156
+ .option("--domain <id>", "id del dominio padre")
157
+ .option("--clear-domain", "desvincula la property de su dominio")
158
+ .option("--favicon <url>", "URL del favicon")
159
+ .option("--primary-metric <id>", "métrica primaria (ej: 'gsc:clicks', 'ads:cost')")
160
+ .action(async (id, opts, cmd) => {
161
+ const flags = readFlags(cmd);
162
+ if (opts.client && opts.clearClient) {
163
+ process.stderr.write("error: --client y --clear-client son mutuamente excluyentes\n");
164
+ process.exit(64);
165
+ }
166
+ if (opts.domain && opts.clearDomain) {
167
+ process.stderr.write("error: --domain y --clear-domain son mutuamente excluyentes\n");
168
+ process.exit(64);
169
+ }
170
+ await run({
171
+ method: "PATCH",
172
+ path: `/properties/${encodeURIComponent(id)}`,
173
+ request: {
174
+ body: {
175
+ displayName: opts.displayName,
176
+ clientId: opts.clearClient ? null : opts.client,
177
+ domainId: opts.clearDomain ? null : opts.domain,
178
+ favicon: opts.favicon,
179
+ primaryMetricId: opts.primaryMetric,
180
+ },
181
+ idempotencyKey: flags.idempotencyKey,
182
+ },
183
+ output: outputFromFlags(flags),
184
+ profile: flags.profile,
185
+ asAgent: flags.asAgent,
186
+ });
187
+ });
149
188
  // ── backlinks
150
189
  const backlink = program.command("backlink").description("Backlinks trackeados (cacheados desde Ahrefs)");
151
190
  backlink
@@ -344,6 +383,27 @@ export function registerGeneric(program) {
344
383
  asAgent: flags.asAgent,
345
384
  });
346
385
  });
386
+ // reconcile subcommand — cross-check suspect rows against Ahrefs.
387
+ backlink
388
+ .command("reconcile")
389
+ .description("Cruza los backlinks sospechosos (removed/broken/blocked/non_crawlable) de un dominio contra Ahrefs y marca desacuerdos para revisión. NO cambia estados. Dry-run por defecto; --confirm gasta unidades Ahrefs (1 sola llamada filtrada, aborta si quedan pocas).")
390
+ .requiredOption("--domain <id>", "id de dominio")
391
+ .option("--confirm", "ejecuta la llamada Ahrefs (sin esto es dry-run y no gasta unidades)")
392
+ .option("--unit-floor <n>", "aborta si quedan menos unidades Ahrefs que esto (default 1500)", (v) => parseInt(v, 10))
393
+ .action(async (opts, cmd) => {
394
+ const flags = readFlags(cmd);
395
+ await run({
396
+ method: "POST",
397
+ path: `/domains/${encodeURIComponent(opts.domain)}/backlinks/reconcile`,
398
+ request: {
399
+ body: { confirm: opts.confirm === true, unitFloor: opts.unitFloor },
400
+ idempotencyKey: flags.idempotencyKey,
401
+ },
402
+ output: outputFromFlags(flags),
403
+ profile: flags.profile,
404
+ asAgent: flags.asAgent,
405
+ });
406
+ });
347
407
  // ── offers (Phase 41 reverse-direction)
348
408
  const offer = program
349
409
  .command("offer")