@curviate/cli 0.47.0 → 0.49.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 (48) hide show
  1. package/CHANGELOG.md +231 -1
  2. package/README.md +136 -88
  3. package/dist/{account-RFJ63QYL.js → account-2BH2Q6VG.js} +41 -31
  4. package/dist/chunk-3RCW7URJ.js +41 -0
  5. package/dist/{chunk-UJOTQPL6.js → chunk-5ZGTU4VD.js} +47 -14
  6. package/dist/chunk-D2S5OCYU.js +38 -0
  7. package/dist/{chunk-HOQ7EUHJ.js → chunk-FDJMAF7D.js} +1 -0
  8. package/dist/{chunk-ERBYEC5P.js → chunk-JYKYD57J.js} +1 -1
  9. package/dist/chunk-MGB6FE4A.js +58 -0
  10. package/dist/chunk-NNV2OYEF.js +23 -0
  11. package/dist/{chunk-76SWLAZ6.js → chunk-RXWODUWA.js} +43 -1
  12. package/dist/{chunk-V3MVOVQT.js → chunk-SA2QHAXG.js} +8 -1
  13. package/dist/chunk-TEAWYLPO.js +1493 -0
  14. package/dist/{chunk-PD2I5TYC.js → chunk-V7FJWTZW.js} +3 -3
  15. package/dist/{chunk-TC4ZPUWI.js → chunk-Y7MZZRYR.js} +21 -80
  16. package/dist/{chunk-FXYK2GTO.js → chunk-Z7OQSWBD.js} +38 -33
  17. package/dist/chunk-ZYURL5VK.js +83 -0
  18. package/dist/cli.js +79 -98
  19. package/dist/{comment-MCXE7B7V.js → comment-MRDPDA33.js} +29 -24
  20. package/dist/{company-EUUN372H.js → company-2AEHSGHA.js} +57 -52
  21. package/dist/{config-K4G3VSBA.js → config-NRBKHXES.js} +13 -5
  22. package/dist/{connect-2AL7XVJO.js → connect-4XEBV5V3.js} +42 -38
  23. package/dist/core-RGU2SCBN.js +46 -0
  24. package/dist/{doctor-WPYI7X2T.js → doctor-BZ4DA7DV.js} +9 -5
  25. package/dist/document-RKHRWXNT.js +27 -0
  26. package/dist/{draft-G65DVXT7.js → draft-C5N6EOO5.js} +27 -22
  27. package/dist/enrollment-BNQOUKI7.js +472 -0
  28. package/dist/examples-NIMSIXMV.js +53 -0
  29. package/dist/{exit-codes-AW6KHDDN.js → exit-codes-TLMKTLRI.js} +1 -1
  30. package/dist/{feed-HV24WME4.js → feed-DFUU7SUJ.js} +15 -11
  31. package/dist/{group-HADXNVJW.js → group-CSD2OWOZ.js} +17 -13
  32. package/dist/{inbox-G3EE54OB.js → inbox-SNSPWI7J.js} +23 -19
  33. package/dist/{inboxes-237XOBTP.js → inboxes-RIRHPS4H.js} +18 -14
  34. package/dist/{job-LIN6RWD7.js → job-6PNXXZNF.js} +31 -27
  35. package/dist/{login-OHAHNBRW.js → login-Y7JBAHCW.js} +10 -5
  36. package/dist/{message-U2O2JQSW.js → message-2IK4MBBG.js} +10 -8
  37. package/dist/motion-7ATUXO6R.js +946 -0
  38. package/dist/{notification-3VG32LWM.js → notification-VYK5NDEB.js} +19 -15
  39. package/dist/{post-ECDK2KJL.js → post-AN6T2OJF.js} +35 -30
  40. package/dist/{profile-JOHS6SDW.js → profile-UQY64642.js} +46 -42
  41. package/dist/{recruiter-7VXEIXN3.js → recruiter-OY4RN5HH.js} +122 -119
  42. package/dist/{sales-nav-K4BMBH7R.js → sales-nav-KLODLYMW.js} +36 -30
  43. package/dist/{search-C2UYO6PI.js → search-NWP5S6CF.js} +68 -58
  44. package/dist/{setup-GYEZFDEN.js → setup-YPPFLH2N.js} +14 -9
  45. package/dist/{webhook-KCOQOH7D.js → webhook-OHKBL3YS.js} +51 -55
  46. package/package.json +2 -2
  47. package/dist/chunk-KJ24DIAJ.js +0 -60
  48. package/dist/examples-IJL3A6SZ.js +0 -18
package/CHANGELOG.md CHANGED
@@ -6,7 +6,237 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
6
6
  Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html):
7
7
  a new command or flag is a minor; a breaking command/flag/exit-code change is a major (before 1.0.0, a minor); a fix is a patch.
8
8
 
9
- ## [Unreleased]
9
+ ## [0.49.0] - 2026-10-22
10
+
11
+ A minor: Motions and Enrollments arrive as top-level groups. Requires
12
+ `@curviate/sdk` 0.44.0 (exact pin). The vendored OpenAPI fixture is re-copied
13
+ from the SDK's fixture.
14
+
15
+ ### Added
16
+
17
+ - `curviate motion`: `list`, `get` (with `--version` for one Sequence
18
+ version), `create --file`, `update --file [--if-revision <n>]`, `start`,
19
+ `pause`, `resume`, `archive`, `delete`, `preview [--sample | --contact]`,
20
+ `add` and `remove` (`--contact`, sent in requests of up to 1000 ids, in
21
+ order; a failed request stops the run and reports what was sent), and two
22
+ offline commands: `lint --file` and `init --template [--output]`.
23
+ - A Motion file is checked before anything is sent: its fields against the
24
+ published schema, its Sequence with the SDK's `validateSequence`. Sequence
25
+ findings print one per line, `<file>:<line>:<col> error R12 <path>: <message>.
26
+ <hint> -> <docs_url>`, the same as `curviate motion lint`.
27
+ - `curviate motion get` output is a Motion file: `motion create --file -` and
28
+ `motion update <id> --file -` accept it, dropping the keys Curviate sets with a
29
+ warning naming each.
30
+ - `curviate motion update --if-revision <n>`: refused with `SEQUENCE_CONFLICT`
31
+ (exit 2) when someone saved the Sequence since; the message names the newer
32
+ revision and who saved it.
33
+ - `curviate motion init --template` writes `connect-and-converse`,
34
+ `engage-then-connect` or `nurture-connections` (which follows up only when the
35
+ first message was seen) in this machine's timezone.
36
+ - `curviate enrollment`: `list` (filters `--motion`, `--contact`, `--status`,
37
+ `--step`, `--version`, `--done-step` with `--outcome`, `--reason`,
38
+ `--variant`, `--relationship`), `get`, `pause`, `resume [--at]`, `retry`,
39
+ `stop`, `event <id> <name>`, `reassign --account`, and `bulk --action` over
40
+ `--id` or `--motion` with the list filters.
41
+ - `curviate enrollment retry` retries only a failed Step (a repeat never sends a
42
+ delivered message again), then waits for the re-run (`--wait-timeout <ms>`, default
43
+ 600000) and prints its outcome, reason and message.
44
+ - In human output, each Enrollment reason reads `<code>: <message>` (skip,
45
+ finish and every history entry); `--json` keeps the API's code and message
46
+ keys.
47
+ - `curviate webhook create --source motion` and `--motion-ids`.
48
+
49
+ ### Changed
50
+
51
+ - `curviate webhook create`: `--account-ids` is optional for every source;
52
+ omitted, the webhook covers every account you can operate, now and later.
53
+ - `curviate enrollment resume --at` is a jump: it re-enters the named Step even
54
+ when that Step already sent. Use `curviate enrollment retry` for a failed Step.
55
+ - Exit codes for the new error codes: `SEQUENCE_INVALID`, `SEQUENCE_CONFLICT`,
56
+ `NOTHING_TO_RETRY`, `MOTION_STATUS_CONFLICT`, `ENROLLMENT_NOT_ACTIVE` and the
57
+ other Motion refusals exit 2; `STEP_IN_FLIGHT` exits 7 (read again in a
58
+ minute); `TIER_REQUIRED` and the team-role codes exit 5; a request timeout
59
+ exits 7.
60
+
61
+ ### Deprecated
62
+
63
+ - `curviate enrollment signal` is an alias of `curviate enrollment event`,
64
+ accepted until 2027-01-19.
65
+
66
+ ## [0.48.0] - 2026-10-19
67
+
68
+ A breaking minor (pre-1.0): the LinkedIn commands move under `curviate core`.
69
+ Still requires `@curviate/sdk` 0.42.0 (exact pin unchanged). The vendored OpenAPI
70
+ fixture is re-copied from the SDK's regenerated fixture (deployed staging, server
71
+ `3b0b7503a516f6a1f39622bd40ec6fec9c217c38`); the pin's version label stays
72
+ `0.42.0` until the SDK release and the pin bump.
73
+
74
+ ### Changed (breaking)
75
+
76
+ The sixteen LinkedIn groups now live under `curviate core`, the LinkedIn
77
+ building blocks; product groups will sit at the top level beside `account` and
78
+ `webhook`. Migrating a script is a prefix change: insert `core ` after
79
+ `curviate`. Every subcommand, positional, flag, default projection, exit code
80
+ and bare form (`core connect <slug>`, `core profile <url>`, `core company <id>`,
81
+ `core message <chat_id> "<text>"`) is unchanged apart from the renames below.
82
+
83
+ - `curviate profile ...` is now `curviate core profile ...`.
84
+ - `curviate company ...` is now `curviate core company ...`.
85
+ - `curviate job ...` is now `curviate core job ...`.
86
+ - `curviate connect ...` is now `curviate core connect ...`.
87
+ - `curviate search ...` is now `curviate core search ...`.
88
+ - `curviate inbox ...` is now `curviate core inbox ...`.
89
+ - `curviate inboxes ...` is now `curviate core inboxes ...`.
90
+ - `curviate message ...` is now `curviate core message ...`.
91
+ - `curviate post ...` is now `curviate core post ...`.
92
+ - `curviate comment ...` is now `curviate core comment ...`.
93
+ - `curviate sales-nav ...` is now `curviate core sales-nav ...`.
94
+ - `curviate recruiter ...` is now `curviate core recruiter ...`.
95
+ - `curviate group ...` is now `curviate core group ...`.
96
+ - `curviate feed ...` is now `curviate core feed ...`.
97
+ - `curviate notification ...` is now `curviate core notification ...`.
98
+ - `curviate draft ...` is now `curviate core draft ...`.
99
+
100
+ **Old paths fail.** Any old path, with or without arguments, and with or without
101
+ `--help` or `-h`, exits 2 with the generic usage error
102
+ (`error: unknown command at argument 1`), sends nothing, and names no
103
+ successor: no hint, no alias, no did-you-mean. Help no longer rescues an
104
+ unknown token either: `curviate profile --help` and `curviate core inbx --help`
105
+ exit 2 instead of printing the nearest help.
106
+
107
+ **`notification` changes meaning.** `curviate notification` is reserved for
108
+ Curviate Notifications, which land in a later release; LinkedIn's notification
109
+ cards are `curviate core notification`. Until then `curviate notification`
110
+ exits 2 like every other old path.
111
+
112
+ **The 0.15.0 successor hints are removed.** `post list`, `connect respond`,
113
+ `profile connections`, `account connect-link`, `account reconnect-link`,
114
+ `account reconnect`, `inbox sync`, `inbox sync-chat`, `recruiter add-candidate`,
115
+ `recruiter project-jobs`, `recruiter sync`, `recruiter add-applicant`,
116
+ `recruiter reject-applicant`, `sales-nav sync` and `webhook state-diff` now get
117
+ the generic usage error with no hint. `core connect respond` is still refused
118
+ (exit 2, nothing sent) instead of sending an invitation to the slug `respond`.
119
+
120
+ **Document flags are renamed to `--file`.** A document is a path or `-`
121
+ (stdin), never inline JSON on the command line:
122
+ - `core recruiter job create`, `core recruiter project-job create` and
123
+ `core recruiter project-job update`: `--body-file <path>` and `--body -` are
124
+ now `--file <path|->`.
125
+ - `webhook verify`: `--body <inline|path|->` is now `--file <path|->`. Inline
126
+ JSON is no longer accepted; pipe it with `--file -`. The bytes are verified
127
+ as given (trailing newlines excepted, as before).
128
+ - `--filters-file` (search, Sales Navigator and Recruiter searches) also
129
+ accepts `-`.
130
+
131
+ A value starting with `{` or `[` given to a file flag, a missing path, a
132
+ directory, empty input, unparsable JSON (named by line and column), `-` while
133
+ stdin is a terminal, and two inputs reading stdin in one call all exit 2 before
134
+ any request.
135
+
136
+ **`core connect --note` help is corrected.** It no longer claims notes raise
137
+ acceptance, and no longer says omitting it sends "a generic note" (omitting it
138
+ sends no note). It now reads: up to 300 characters on LinkedIn Premium, 200
139
+ on a free account, a note on about 5 invitations a month (budget row
140
+ `connection_requests_with_note`).
141
+
142
+ ### Added
143
+
144
+ - **`curviate core`** prints its sixteen groups and the rules every core
145
+ command shares (writes are immediate and visible, a retry can repeat a write,
146
+ budgets are in `curviate account get`). `curviate core` alone prints the same
147
+ as `curviate core --help`, exit 0. Root help ends with a SEE ALSO naming the
148
+ skill plugin and the CLI reference.
149
+ - **Help sections in one fixed order**: usage, DOCUMENT, RULES, REQUIRES,
150
+ OUTPUT, ERRORS, SEE ALSO, EXAMPLES (always last), each only when it applies.
151
+ `commands.json` carries the same data (`risk`, `rules`, `errors`, `seeAlso`,
152
+ `document`), so the docs render the same sections. `account disconnect` and
153
+ `webhook delete` carry them in full; the other commands follow in a later
154
+ release.
155
+ - **Recruiter job documents are checked before sending.** The merged document
156
+ (`--file` plus named flags) is validated against the published schema; every
157
+ problem is listed in one run as `<path>: <rule>`, a misspelt field names its
158
+ closest valid name, no field value is ever echoed, nothing is sent, exit 2.
159
+ With `--json`, stdout carries `{"error": {"code": "INVALID_REQUEST", ...,
160
+ "errors": [{"path", "rule", "suggestion"?}]}}`. Help prints the field table
161
+ (DOCUMENT) rendered from the same schema, and the last example is a complete
162
+ `--file -` heredoc.
163
+ - **A mistyped flag names the close one**: `core connect janesmith --not "x"`
164
+ exits 2 with `hint: did you mean --note?` when exactly one declared flag is
165
+ within two edits. A command name is never suggested.
166
+
167
+ ### Fixed
168
+
169
+ - **A write the API accepted exits 0.** A 2xx answer to a write whose body is
170
+ empty, not JSON, or not the expected shape prints the JSON body verbatim (or
171
+ `{}` when it is not JSON), warns on stderr, and exits 0, instead of exit 7
172
+ that invited a retry and a duplicate. A read given such a body still exits 7.
173
+ The account checkpoint flow (`account checkpoint solve|poll|request`,
174
+ `account connect-session poll`) keeps exit 7, because its next step is read
175
+ from the body, but now says the request may have been applied
176
+ (`retryLikelyToSucceed: false`) and names the command that reads the state
177
+ back (`curviate account checkpoint poll` or `curviate account connect-session
178
+ poll`), instead of inviting a resend.
179
+ - **A document is at most 5 MiB.** A larger `--file`, `--filters-file` or
180
+ `webhook verify --file` input (a file, a device such as `/dev/zero`, or stdin)
181
+ exits 2 instead of exhausting memory.
182
+ - **Help names every command by its full path** (`curviate core company chats`,
183
+ not `company chats`).
184
+ - **`--help` loads only what it describes**: `curviate --help` and
185
+ `curviate core --help` import no command module.
186
+ - **A malformed number is refused, never sent as another value.** `--limit`
187
+ (every command that takes it), `--date-posted` on `core search jobs`,
188
+ `--network-distance` and `--connections`, `--proxy-port`, the wait-loop
189
+ `--timeout` (1 to 2147483647 ms, a sane bound for a wait) and `webhook verify --max-age-secs` take digits only, in range,
190
+ or exit 2 before any request. Before, `--limit abc` sent `limit=NaN`,
191
+ `--limit 5abc` sent 5, `--date-posted 7d` sent `null`, `--network-distance
192
+ 1,x` dropped the `x` (an empty value or an empty segment, `""` or `1,,2`,
193
+ is refused too), `--proxy-port 80x` sent 80, and `--max-age-secs abc`
194
+ turned the replay check off.
195
+ - **`--api-key -` is refused outside `curviate login`** (exit 2, nothing
196
+ sent). It was sent as the key itself (`Bearer -`) and reported as a
197
+ credential failure. Use `CURVIATE_API_KEY`, or `curviate login --api-key -`.
198
+ - **A document must be UTF-8 without a byte order mark.** A file flag
199
+ (`--file`, `--filters-file`, `webhook verify --file`) given Latin-1 bytes
200
+ exits 2 instead of sending U+FFFD in their place; a BOM is named instead of
201
+ failing the JSON parse at a column you cannot see (or the signature check
202
+ as a wrong secret). `--filters-file`, `--filters -` and inline `--filters`
203
+ name the line and column of a JSON fault, like `--file`, and `--filters -`
204
+ is capped at 5 MiB like every other document read.
205
+ - **A usage error points at the command's own help**: an unknown or repeated
206
+ flag, a missing or stray positional, ends with ``Run `curviate core connect sent
207
+ --help` for usage.`` (the command's full path). An unknown command keeps
208
+ the root pointer.
209
+ - **A write that meets an unreadable 5xx is not retry-likely.** The
210
+ synthesized `PLATFORM_ERROR` (exit 7 as before) on a non-GET write now says
211
+ the request may have been applied and carries `retryLikelyToSucceed:
212
+ false` (`account checkpoint solve|request` name `curviate account
213
+ checkpoint poll` to read the state back). A GET keeps
214
+ `true` (`connect-session poll` also keeps the SDK's read retries);
215
+ `account checkpoint poll` (a read sent as POST) keeps `true` too but sends
216
+ one request and does not retry.
217
+ - **DOCUMENT lists each field once.** A field in several `oneOf` branches is
218
+ one row (`apply_method.method`: one of linkedin, external), and a field only
219
+ one branch requires says which (`required if method is "linkedin"`,
220
+ `required in {id}`).
221
+ - **`config path`, `config use` and `config rename` accept `--json`** (a
222
+ wrapper that prepends it no longer gets exit 2). `config path --json`
223
+ prints `{"config_path": "..."}`; without it the bare path, as before.
224
+ - Help copy names `curviate core search posts`, `curviate core search
225
+ parameters`, `curviate core recruiter search parameters` and `curviate core
226
+ comment list` by full path; the `curviate core profile` usage lists
227
+ `subscription`, `analytics`, `visitors` and `ssi`.
228
+
229
+ ### Changed
230
+
231
+ - **The activity window applies to every account, with or without a timezone.**
232
+ A server change, no CLI flag or output changes. An account with no zone set is
233
+ read in the zone its user's browser reported, else one inferred from the
234
+ LinkedIn profile location, else `Europe/Berlin`; a zone you set still wins.
235
+ `account get --verbose` now carries
236
+ `activity_window.effective_timezone` and `activity_window.source` (`account`,
237
+ `browser`, `location` or `default`). A `BUDGET_EXHAUSTED` with
238
+ `safetyReason: "activity_window"` can now reach an account that had no zone.
239
+ The CLI's refusal text ("outside its activity window") needed no change.
10
240
 
11
241
  ## [0.47.0] - 2026-10-07
12
242