@cavuno/board 4.4.1 → 4.6.0

package/skills/cavuno-board-account/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: cavuno-board-account
-description: Candidate self-service boundary with @cavuno/board. Use for account, profile, resume onboarding, avatar, experience, education, skills, languages, or notification preferences.
+description: Candidate self-service boundary with @cavuno/board. Use for account, profile, resume onboarding, recommended jobs, avatar, experience, education, skills, languages, or notification preferences.
 ---
 
 # Candidate self-service boundary
 
 Signed-in candidate data lives under `board.me`. Browser calls use the bearer token in `auth.storage`; server calls pass it per request in `options.headers`. See `cavuno-board-auth` for cookie-based server sessions.
 
-The only anonymous method here is token-based email unsubscribe. Applications, employer companies, messaging, and alerts have their own skills.
+Anonymous methods here are token-based email unsubscribe and email-change confirm (`confirmEmailChange`). Applications, employer companies, messaging, and alerts have their own skills.
 
 The host application owns forms, file pickers, and cookie plumbing; this SDK surface supplies data operations.
 
@@ -15,10 +15,20 @@ The host application owns forms, file pickers, and cookie plumbing; this SDK sur
 
 Account deletion is a synchronous, irreversible cascade over the profile, collections, saved jobs, alerts, avatar, and resume. Obtain explicit confirmation before calling it.
 
+Change the password with the current password. The SDK persists the returned session so the caller stays signed in. Passwordless accounts (magic-link or OAuth) get `no_password` — send them through `auth.forgotPassword` instead.
+
 ```ts snippet
 const me = await board.me.retrieve();
 await board.me.delete();
 
+await board.me.updatePassword({
+  currentPassword: 'oldpass99',
+  newPassword: 'newpass99',
+});
+
+await board.me.requestEmailChange({ email: 'new@example.com' });
+await board.me.confirmEmailChange({ token });
+
 const profile = await board.me.profile.retrieve();
 await board.me.profile.update({
   headline: 'Staff Engineer',
@@ -104,6 +114,24 @@ if (resume.parseStatus === 'parsed') {
 
 Upload options also include `importMode: 'append_only' | 'replace_all'` and `confirmReplaceAll`. `resume.file.url` is a short-lived signed URL. `parseStatus` is null before any parse. `board.me.resume.delete()` removes the stored file and keep-on-file consent while retaining imported profile fields.
 
+## Recommended jobs
+
+`board.me.recommendedJobs.list` is the sibling of `savedJobs.list`. Each item wraps the same slim `PublicJobCard` (`{ object: 'recommended_job', job }`). Order is the ranking. The endpoint never returns scores, weights, or ranker identity.
+
+Cold start is an empty list — no hint field. Drive an upload-resume CTA from `board.me.profile` / `board.me.resume` (`parseStatus`, skills), not from the list response.
+
+```ts snippet
+const { data } = await board.me.recommendedJobs.list({ limit: 20 });
+data[0]?.job.title;
+
+const profile = await board.me.profile.retrieve();
+const skills = await board.me.profile.listSkills();
+const resume = await board.me.resume.retrieve();
+if (data.length === 0 && (skills.data.length === 0 || resume.parseStatus !== 'parsed')) {
+  promptResumeUpload();
+}
+```
+
 ## Notification preferences
 
 Authenticated settings expose `messageEmails` and `applicationEmails`. Updating one channel returns the full set.
@@ -132,6 +160,7 @@ await board.me.notificationPreferences.unsubscribeWithToken({
 - Adding a skill preserves every existing skill.
 - Uploaded `avatarUrl` renders.
 - Resume parsing reaches `parsed`, reports `parseFailureReason`, or reaches the explicit delayed state without blocking editing.
+- Recommended jobs render the returned cards in list order; an empty list plus missing skills / unparsed resume shows an upload-resume prompt.
 - Anonymous unsubscribe works in a logged-out browser.
 
 ## Cavuno SDK reference

package/skills/cavuno-board-companies/SKILL.md

@@ -12,6 +12,27 @@ Board-wide jobs use `jobs.*`, board-wide salary hubs use `salaries.*`, and
 employer self-service uses authenticated `board.me.companies.*`. The host app
 owns admin writes, sitemaps, and OG-image routes.
 
+An approved admin can delete a company they manage and can list, retitle, or
+remove members. Any approved member can leave with `board.me.companies.leave`.
+Demoting, removing, or leaving as the last admin is `last_admin`. Admins
+invite by email; approved members can list pending invites; accept is
+session-gated on `board.me.acceptInvite`.
+
+```ts snippet
+await board.me.companies.delete('acme');
+const { data: members } = await board.me.companies.listMembers('acme');
+await board.me.companies.updateMemberRole('acme', members[0].id, {
+  role: 'admin',
+});
+await board.me.companies.removeMember('acme', members[0].id);
+await board.me.companies.leave('acme');
+
+const { data: invites } = await board.me.companies.listInvites('acme');
+await board.me.companies.createInvite('acme', { email: 'ada@acme.test' });
+await board.me.companies.revokeInvite('acme', invites[0].id);
+const { companySlug } = await board.me.acceptInvite({ token });
+```
+
 ## List and search
 
 `companies.list` returns `CompanyListEnvelope`: `ListEnvelope<PublicCompany>`

package/skills/cavuno-board-seo/SALARY.md

@@ -102,7 +102,8 @@ const index = itemListJsonLd([
 - `formatSalaryStat(locale, value, currency, notation?)` /
   `formatSalaryStatRange(locale, min, max, currency, notation?)` for
   salary-page amounts (currency from the detail, not hardcoded USD;
-  `formatRange` owns the join). `notation` matches `formatSalaryRange`
+  `formatRange` owns the join when present, else two `format()` calls
+  joined with an en-dash). `notation` matches `formatSalaryRange`
   (magnitude default when omitted; pass `'standard'` for full figures).
   Returns `null` when currency is empty or `Intl` rejects inputs.
 - `SENIORITY_ORDER` / `sortBySeniority` for seniority ladder ordering

package/skills/manifest.json

@@ -1,9 +1,9 @@
 {
-  "version": "4.4.1",
+  "version": "4.6.0",
   "skills": [
     {
       "name": "cavuno-board-account",
-      "description": "Candidate self-service boundary with @cavuno/board. Use for account, profile, resume onboarding, avatar, experience, education, skills, languages, or notification preferences.",
+      "description": "Candidate self-service boundary with @cavuno/board. Use for account, profile, resume onboarding, recommended jobs, avatar, experience, education, skills, languages, or notification preferences.",
       "path": "skills/cavuno-board-account/SKILL.md",
       "framework": null,
       "category": "core"