@curviate/cli 0.47.0 → 0.48.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 +174 -1
  2. package/README.md +101 -87
  3. package/dist/{account-RFJ63QYL.js → account-WKQHMM7P.js} +39 -29
  4. package/dist/chunk-AYKKXGTR.js +1141 -0
  5. package/dist/{chunk-TC4ZPUWI.js → chunk-CVMSQ3OF.js} +19 -80
  6. package/dist/{chunk-HOQ7EUHJ.js → chunk-FDJMAF7D.js} +1 -0
  7. package/dist/chunk-GQKC6E5K.js +36 -0
  8. package/dist/{chunk-V3MVOVQT.js → chunk-MKGVNDMJ.js} +8 -1
  9. package/dist/chunk-NNV2OYEF.js +23 -0
  10. package/dist/{chunk-UJOTQPL6.js → chunk-OHXYFICP.js} +47 -14
  11. package/dist/{chunk-PD2I5TYC.js → chunk-Q63IIPL2.js} +2 -2
  12. package/dist/chunk-TSOIZBBU.js +41 -0
  13. package/dist/{chunk-ERBYEC5P.js → chunk-Y7K4UBFC.js} +1 -1
  14. package/dist/{chunk-FXYK2GTO.js → chunk-YFXLXION.js} +37 -32
  15. package/dist/chunk-ZYURL5VK.js +83 -0
  16. package/dist/cli.js +76 -97
  17. package/dist/{comment-MCXE7B7V.js → comment-7IQ6ZOJF.js} +27 -22
  18. package/dist/{company-EUUN372H.js → company-RD7RDGSA.js} +55 -50
  19. package/dist/{config-K4G3VSBA.js → config-EYBNYRGK.js} +13 -5
  20. package/dist/{connect-2AL7XVJO.js → connect-HVXT67A6.js} +35 -31
  21. package/dist/core-6XYGUNAY.js +46 -0
  22. package/dist/{doctor-WPYI7X2T.js → doctor-HUXQERLQ.js} +8 -4
  23. package/dist/document-AUUCGST2.js +27 -0
  24. package/dist/{draft-G65DVXT7.js → draft-DFO22K6Q.js} +26 -21
  25. package/dist/examples-64YT5V5K.js +53 -0
  26. package/dist/{feed-HV24WME4.js → feed-JWP6ANPI.js} +13 -9
  27. package/dist/{group-HADXNVJW.js → group-SIQFJEZV.js} +15 -11
  28. package/dist/{inbox-G3EE54OB.js → inbox-MMIMCA5O.js} +21 -17
  29. package/dist/{inboxes-237XOBTP.js → inboxes-RND3D4C7.js} +16 -12
  30. package/dist/{job-LIN6RWD7.js → job-ACFKBLFK.js} +29 -25
  31. package/dist/{login-OHAHNBRW.js → login-ZOB5KVKQ.js} +10 -5
  32. package/dist/{message-U2O2JQSW.js → message-OFK6UVXR.js} +9 -7
  33. package/dist/{notification-3VG32LWM.js → notification-KKGAZU7M.js} +17 -13
  34. package/dist/{post-ECDK2KJL.js → post-A5SBCFB2.js} +33 -28
  35. package/dist/{profile-JOHS6SDW.js → profile-4SOOQZ4K.js} +45 -41
  36. package/dist/{recruiter-7VXEIXN3.js → recruiter-YN73STDP.js} +123 -120
  37. package/dist/{sales-nav-K4BMBH7R.js → sales-nav-JXF5RY2K.js} +38 -32
  38. package/dist/{search-C2UYO6PI.js → search-JAL242A2.js} +58 -48
  39. package/dist/{setup-GYEZFDEN.js → setup-WICWH4JG.js} +13 -8
  40. package/dist/{webhook-KCOQOH7D.js → webhook-UGKVYWBC.js} +34 -36
  41. package/package.json +1 -1
  42. package/dist/chunk-KJ24DIAJ.js +0 -60
  43. package/dist/examples-IJL3A6SZ.js +0 -18
package/CHANGELOG.md CHANGED
@@ -6,7 +6,180 @@ 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.48.0] - 2026-10-19
10
+
11
+ A breaking minor (pre-1.0): the LinkedIn commands move under `curviate core`.
12
+ Still requires `@curviate/sdk` 0.42.0 (exact pin unchanged). The vendored OpenAPI
13
+ fixture is re-copied from the SDK's regenerated fixture (deployed staging, server
14
+ `3b0b7503a516f6a1f39622bd40ec6fec9c217c38`); the pin's version label stays
15
+ `0.42.0` until the SDK release and the pin bump.
16
+
17
+ ### Changed (breaking)
18
+
19
+ The sixteen LinkedIn groups now live under `curviate core`, the LinkedIn
20
+ building blocks; product groups will sit at the top level beside `account` and
21
+ `webhook`. Migrating a script is a prefix change: insert `core ` after
22
+ `curviate`. Every subcommand, positional, flag, default projection, exit code
23
+ and bare form (`core connect <slug>`, `core profile <url>`, `core company <id>`,
24
+ `core message <chat_id> "<text>"`) is unchanged apart from the renames below.
25
+
26
+ - `curviate profile ...` is now `curviate core profile ...`.
27
+ - `curviate company ...` is now `curviate core company ...`.
28
+ - `curviate job ...` is now `curviate core job ...`.
29
+ - `curviate connect ...` is now `curviate core connect ...`.
30
+ - `curviate search ...` is now `curviate core search ...`.
31
+ - `curviate inbox ...` is now `curviate core inbox ...`.
32
+ - `curviate inboxes ...` is now `curviate core inboxes ...`.
33
+ - `curviate message ...` is now `curviate core message ...`.
34
+ - `curviate post ...` is now `curviate core post ...`.
35
+ - `curviate comment ...` is now `curviate core comment ...`.
36
+ - `curviate sales-nav ...` is now `curviate core sales-nav ...`.
37
+ - `curviate recruiter ...` is now `curviate core recruiter ...`.
38
+ - `curviate group ...` is now `curviate core group ...`.
39
+ - `curviate feed ...` is now `curviate core feed ...`.
40
+ - `curviate notification ...` is now `curviate core notification ...`.
41
+ - `curviate draft ...` is now `curviate core draft ...`.
42
+
43
+ **Old paths fail.** Any old path, with or without arguments, and with or without
44
+ `--help` or `-h`, exits 2 with the generic usage error
45
+ (`error: unknown command at argument 1`), sends nothing, and names no
46
+ successor: no hint, no alias, no did-you-mean. Help no longer rescues an
47
+ unknown token either: `curviate profile --help` and `curviate core inbx --help`
48
+ exit 2 instead of printing the nearest help.
49
+
50
+ **`notification` changes meaning.** `curviate notification` is reserved for
51
+ Curviate Notifications, which land in a later release; LinkedIn's notification
52
+ cards are `curviate core notification`. Until then `curviate notification`
53
+ exits 2 like every other old path.
54
+
55
+ **The 0.15.0 successor hints are removed.** `post list`, `connect respond`,
56
+ `profile connections`, `account connect-link`, `account reconnect-link`,
57
+ `account reconnect`, `inbox sync`, `inbox sync-chat`, `recruiter add-candidate`,
58
+ `recruiter project-jobs`, `recruiter sync`, `recruiter add-applicant`,
59
+ `recruiter reject-applicant`, `sales-nav sync` and `webhook state-diff` now get
60
+ the generic usage error with no hint. `core connect respond` is still refused
61
+ (exit 2, nothing sent) instead of sending an invitation to the slug `respond`.
62
+
63
+ **Document flags are renamed to `--file`.** A document is a path or `-`
64
+ (stdin), never inline JSON on the command line:
65
+ - `core recruiter job create`, `core recruiter project-job create` and
66
+ `core recruiter project-job update`: `--body-file <path>` and `--body -` are
67
+ now `--file <path|->`.
68
+ - `webhook verify`: `--body <inline|path|->` is now `--file <path|->`. Inline
69
+ JSON is no longer accepted; pipe it with `--file -`. The bytes are verified
70
+ as given (trailing newlines excepted, as before).
71
+ - `--filters-file` (search, Sales Navigator and Recruiter searches) also
72
+ accepts `-`.
73
+
74
+ A value starting with `{` or `[` given to a file flag, a missing path, a
75
+ directory, empty input, unparsable JSON (named by line and column), `-` while
76
+ stdin is a terminal, and two inputs reading stdin in one call all exit 2 before
77
+ any request.
78
+
79
+ **`core connect --note` help is corrected.** It no longer claims notes raise
80
+ acceptance, and no longer says omitting it sends "a generic note" (omitting it
81
+ sends no note). It now reads: up to 300 characters on LinkedIn Premium, 200
82
+ on a free account, a note on about 5 invitations a month (budget row
83
+ `connection_requests_with_note`).
84
+
85
+ ### Added
86
+
87
+ - **`curviate core`** prints its sixteen groups and the rules every core
88
+ command shares (writes are immediate and visible, a retry can repeat a write,
89
+ budgets are in `curviate account get`). `curviate core` alone prints the same
90
+ as `curviate core --help`, exit 0. Root help ends with a SEE ALSO naming the
91
+ skill plugin and the CLI reference.
92
+ - **Help sections in one fixed order**: usage, DOCUMENT, RULES, REQUIRES,
93
+ OUTPUT, ERRORS, SEE ALSO, EXAMPLES (always last), each only when it applies.
94
+ `commands.json` carries the same data (`risk`, `rules`, `errors`, `seeAlso`,
95
+ `document`), so the docs render the same sections. `account disconnect` and
96
+ `webhook delete` carry them in full; the other commands follow in a later
97
+ release.
98
+ - **Recruiter job documents are checked before sending.** The merged document
99
+ (`--file` plus named flags) is validated against the published schema; every
100
+ problem is listed in one run as `<path>: <rule>`, a misspelt field names its
101
+ closest valid name, no field value is ever echoed, nothing is sent, exit 2.
102
+ With `--json`, stdout carries `{"error": {"code": "INVALID_REQUEST", ...,
103
+ "errors": [{"path", "rule", "suggestion"?}]}}`. Help prints the field table
104
+ (DOCUMENT) rendered from the same schema, and the last example is a complete
105
+ `--file -` heredoc.
106
+ - **A mistyped flag names the close one**: `core connect janesmith --not "x"`
107
+ exits 2 with `hint: did you mean --note?` when exactly one declared flag is
108
+ within two edits. A command name is never suggested.
109
+
110
+ ### Fixed
111
+
112
+ - **A write the API accepted exits 0.** A 2xx answer to a write whose body is
113
+ empty, not JSON, or not the expected shape prints the JSON body verbatim (or
114
+ `{}` when it is not JSON), warns on stderr, and exits 0, instead of exit 7
115
+ that invited a retry and a duplicate. A read given such a body still exits 7.
116
+ The account checkpoint flow (`account checkpoint solve|poll|request`,
117
+ `account connect-session poll`) keeps exit 7, because its next step is read
118
+ from the body, but now says the request may have been applied
119
+ (`retryLikelyToSucceed: false`) and names the command that reads the state
120
+ back (`curviate account checkpoint poll` or `curviate account connect-session
121
+ poll`), instead of inviting a resend.
122
+ - **A document is at most 5 MiB.** A larger `--file`, `--filters-file` or
123
+ `webhook verify --file` input (a file, a device such as `/dev/zero`, or stdin)
124
+ exits 2 instead of exhausting memory.
125
+ - **Help names every command by its full path** (`curviate core company chats`,
126
+ not `company chats`).
127
+ - **`--help` loads only what it describes**: `curviate --help` and
128
+ `curviate core --help` import no command module.
129
+ - **A malformed number is refused, never sent as another value.** `--limit`
130
+ (every command that takes it), `--date-posted` on `core search jobs`,
131
+ `--network-distance` and `--connections`, `--proxy-port`, the wait-loop
132
+ `--timeout` (1 to 2147483647 ms, a sane bound for a wait) and `webhook verify --max-age-secs` take digits only, in range,
133
+ or exit 2 before any request. Before, `--limit abc` sent `limit=NaN`,
134
+ `--limit 5abc` sent 5, `--date-posted 7d` sent `null`, `--network-distance
135
+ 1,x` dropped the `x` (an empty value or an empty segment, `""` or `1,,2`,
136
+ is refused too), `--proxy-port 80x` sent 80, and `--max-age-secs abc`
137
+ turned the replay check off.
138
+ - **`--api-key -` is refused outside `curviate login`** (exit 2, nothing
139
+ sent). It was sent as the key itself (`Bearer -`) and reported as a
140
+ credential failure. Use `CURVIATE_API_KEY`, or `curviate login --api-key -`.
141
+ - **A document must be UTF-8 without a byte order mark.** A file flag
142
+ (`--file`, `--filters-file`, `webhook verify --file`) given Latin-1 bytes
143
+ exits 2 instead of sending U+FFFD in their place; a BOM is named instead of
144
+ failing the JSON parse at a column you cannot see (or the signature check
145
+ as a wrong secret). `--filters-file`, `--filters -` and inline `--filters`
146
+ name the line and column of a JSON fault, like `--file`, and `--filters -`
147
+ is capped at 5 MiB like every other document read.
148
+ - **A usage error points at the command's own help**: an unknown or repeated
149
+ flag, a missing or stray positional, ends with ``Run `curviate core connect sent
150
+ --help` for usage.`` (the command's full path). An unknown command keeps
151
+ the root pointer.
152
+ - **A write that meets an unreadable 5xx is not retry-likely.** The
153
+ synthesized `PLATFORM_ERROR` (exit 7 as before) on a non-GET write now says
154
+ the request may have been applied and carries `retryLikelyToSucceed:
155
+ false` (`account checkpoint solve|request` name `curviate account
156
+ checkpoint poll` to read the state back). A GET keeps
157
+ `true` (`connect-session poll` also keeps the SDK's read retries);
158
+ `account checkpoint poll` (a read sent as POST) keeps `true` too but sends
159
+ one request and does not retry.
160
+ - **DOCUMENT lists each field once.** A field in several `oneOf` branches is
161
+ one row (`apply_method.method`: one of linkedin, external), and a field only
162
+ one branch requires says which (`required if method is "linkedin"`,
163
+ `required in {id}`).
164
+ - **`config path`, `config use` and `config rename` accept `--json`** (a
165
+ wrapper that prepends it no longer gets exit 2). `config path --json`
166
+ prints `{"config_path": "..."}`; without it the bare path, as before.
167
+ - Help copy names `curviate core search posts`, `curviate core search
168
+ parameters`, `curviate core recruiter search parameters` and `curviate core
169
+ comment list` by full path; the `curviate core profile` usage lists
170
+ `subscription`, `analytics`, `visitors` and `ssi`.
171
+
172
+ ### Changed
173
+
174
+ - **The activity window applies to every account, with or without a timezone.**
175
+ A server change, no CLI flag or output changes. An account with no zone set is
176
+ read in the zone its user's browser reported, else one inferred from the
177
+ LinkedIn profile location, else `Europe/Berlin`; a zone you set still wins.
178
+ `account get --verbose` now carries
179
+ `activity_window.effective_timezone` and `activity_window.source` (`account`,
180
+ `browser`, `location` or `default`). A `BUDGET_EXHAUSTED` with
181
+ `safetyReason: "activity_window"` can now reach an account that had no zone.
182
+ The CLI's refusal text ("outside its activity window") needed no change.
10
183
 
11
184
  ## [0.47.0] - 2026-10-07
12
185