@cavuno/board 4.27.0 → 4.28.0

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

@@ -96,6 +96,55 @@ the same card view-model as listings — do not convert a full job client-side.
 const card = toJobCardVM(saved.job, { language, /* … */ });
 ```
 
+## Badges on job cards
+
+Every job card (listings, search, company jobs, similar, recommended, and
+saved jobs) carries `customFieldValues` for the job and
+`company.customFieldValues` for its company. Both hold only select, boolean,
+and number values keyed by field key; select values are option keys. Text
+fields stay on the full job and company, and private company fields never
+appear. Both are `{}` when empty, so a card needs no extra request to show a
+badge.
+
+```ts snippet
+import { resolveCustomFieldDisplay } from '@cavuno/board/format';
+
+const context = await board.context();
+const companyFields = await board.profileFields.retrieve('company');
+
+// Badge only the fields the operator wants on cards (an app-config list).
+const JOB_BADGE_KEYS = ['work_type'];
+const jobBadges = resolveCustomFieldDisplay(
+  context.language,
+  context.customFields.job.filter((field) => JOB_BADGE_KEYS.includes(field.key)),
+  card.customFieldValues).flatMap((entry) => {
+  switch (entry.kind) {
+    case 'text': // a single_select resolves to its option label
+      return [entry.value];
+    case 'multi_select':
+      return entry.values;
+    case 'boolean':
+      return entry.value ? [entry.label] : [];
+    case 'number':
+      return [`${entry.label}: ${entry.value}`];
+  }
+});
+
+// Company badge: resolve the stored option key to its public label.
+const employerField = companyFields.definitions.find(
+  (field) => field.key === 'employer_category');
+const employerKey = card.company?.customFieldValues.employer_category;
+const employerBadge =
+  typeof employerKey === 'string'
+    ? (employerField?.options?.find((option) => option.key === employerKey)
+        ?.label ?? null)
+    : null;
+```
+
+Load the definitions once per page (both are cacheable board metadata), not
+once per card. A key with no current definition or option resolves to nothing:
+drop the badge rather than printing the raw key.
+
 ## Completion gate
 
 Finish only after every applicable check passes:
@@ -107,6 +156,9 @@ Finish only after every applicable check passes:
 - Open ranges return `bound: 'from' | 'upTo'`; the application adds open-range
   chrome and composes order itself.
 - Saved jobs arrive as cards; no `fullJobToCard` conversion.
+- Card badges read `card.customFieldValues` / `card.company.customFieldValues`
+  and resolve option keys to labels through the definitions; no raw key is
+  shown and no card triggers a per-job detail fetch.
 - Salary-stat formatters receive the detail's `currency` (never invent USD).
 - Formatting changes neither salary amounts nor invents chrome words.
 

package/skills/cavuno-board-post-a-job/SKILL.md

@@ -87,6 +87,30 @@ The list replaces the job's wording: omit it on `update` to keep what is stored,
 
 Validate `required` client-side from these entries before submitting, so the poster sees a missing field before the request.
 
+## Pick office locations
+
+Back the `location` field with `board.locations.search`, a worldwide search over countries, regions, cities, and localities. `session` is required: generate one per location-field interaction, reuse it across keystrokes and the pick-time `board.locations.resolve` call, then generate a new one for the next interaction. Renew it before 50 search requests or after 180 seconds. Pass `jobForm.location.allowedCountries` as `country` to narrow suggestions to the board's allowed countries.
+
+```ts snippet
+const session = crypto.randomUUID();
+const { data: locations } = await board.locations.search({
+  q: 'berl',
+  session,
+  country: jobForm.location.allowedCountries?.join(','),
+});
+
+const picked = locations[0];
+if (picked) {
+  const location = await board.locations.resolve({
+    locationId: picked.id,
+    session,
+  });
+  submission.officeLocations.push({ locationId: location.id });
+}
+```
+
+Show `fullName` in the input once picked and `contextLabel` as the secondary line in the result list. Resolve the picked `id` with the same session before committing the selection, then send the resolved `id` as `locationId` in the later job submission. `board.taxonomy.places.list({ q })` ids are accepted as `locationId` too. An id the server does not recognise throws `locations_invalid_id`, and `locations_unavailable` means the search is temporarily down, so let the poster retry.
+
 ## Resolve a logo
 
 Both logo paths return a stored `publicUrl` for `create`. The SDK owns multipart encoding.

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

@@ -37,6 +37,13 @@ const companies = await board.salaries.companies.list();
 region, and city nesting from each `SalaryLocation.parentSlug`; top-level rows
 have `parentSlug: null`.
 
+Every place row in a salary response (location index nodes, `topLocations`,
+child, sibling, and other locations) carries `placeName` and `placeLabel`.
+Render `placeLabel` wherever places are listed: it tells a city from the
+region it shares a name with ("New York, NY" under "New York", "Washington,
+DC" beside "Washington"). Keep `placeName` for data you pass on, such as
+JSON-LD.
+
 ## Retrieve detail and canonicalize slugs
 
 Every axis `retrieve(slug)` accepts an inbound English or board-language slug.

package/skills/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.27.0",
+  "version": "4.28.0",
   "skills": [
     {
       "name": "cavuno-board-account",
@@ -59,7 +59,7 @@
     },
     {
       "name": "cavuno-board-filters",
-      "description": "Listing-filter contracts with @cavuno/board. Use for job filter controls, profile-field filters, collection choices, sort controls, listing URL validation, or taxonomy-backed filter options.",
+      "description": "Listing-filter contracts with @cavuno/board. Use for job filter controls, job and company custom-field filters, profile-field filters, collection choices, sort controls, listing URL validation, or taxonomy-backed filter options.",
       "path": "skills/cavuno-board-filters/SKILL.md",
       "framework": null,
       "category": "core"