jobhunt-kit 0.2.0

package/plugins/jobhunt-kit/references/hirify/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/plugins/jobhunt-kit/references/hirify/NOTICE

@@ -0,0 +1,2 @@
+Hirify CLI
+Copyright 2026 Hirify

package/plugins/jobhunt-kit/references/hirify/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: hirify
+description: Job search through Hirify - vacancies from the user's saved feeds, search across the board, reading a vacancy in full, the contact to apply to, applying on Hirify, and saved searches with delivery. Use when the user asks to find jobs, look at their feeds, pick roles that fit their profile, apply, or set up alerts. Triggers - "find jobs", "what is in my feed", "where do I apply", "apply to this", "hirify".
+---
+
+# Hirify job search
+
+Use the Hirify job board through the `hirify` CLI. This file gives the working order; `reference.md`
+has every command in full, and `hirify intro` is the server's guide.
+
+## What stays here, and what you fetch
+
+This installed file holds only stable rules. Fetch anything Hirify can change:
+
+| What you need | Ask for it |
+|---|---|
+| Filter names and their values | `hirify filter guide` |
+| Reveals, vacancy opens and applies left | `hirify account show` |
+| Rate limits, plan, abilities | `hirify account show --json` |
+| The commands that exist | `hirify --help`, `hirify <noun>` |
+
+## Two rules before anything else
+
+**Lists are free. Three commands are metered, and they spend different things.**
+
+- `vacancy read` spends one of the day's vacancy opens. Re-reading a vacancy the same day is free.
+- `vacancy reveal` spends 1 reveal, and reveals are scarce. When they run out, reading still works.
+- `vacancy apply` counts against a small daily allowance of its own and **cannot be taken back**. It
+  sends a real application, with the user's name and profile, to a person who will read it.
+
+**`hirify account show` is the only place these numbers are true.** Read it before spending; never
+state what is left from memory or plan a batch on a stale figure.
+
+**Ask the user before every apply, and before anything that changes their account.** Reading needs
+no permission. Sending, saving and configuring do.
+
+## Working order
+
+```bash
+hirify account show
+hirify feed list
+hirify feed show <id>
+hirify vacancy search "senior go"
+hirify vacancy read <slug>
+hirify vacancy reveal <slug>
+hirify vacancy apply <slug>
+```
+
+1. `hirify account show` before revealing anything.
+2. Feeds first, search second. A feed is a filter the user built, so it already says what they want.
+3. Shortlist **from the cards**. They carry no contacts, and that is normal.
+4. `hirify vacancy read` the shortlist. The card is a headline; the text is where fit is decided, and
+   reading is cheap. Judging fit without reading is guessing.
+5. `hirify vacancy reveal` only what still fits after reading. A reveal spent at random is spent.
+6. Apply only after the user says yes, and read the rules below first.
+
+## Searching
+
+`vacancy search` takes a phrase and any criterion the site's filter form can express, passed as an
+option under its own name. `--limit` sets the page size and `--page` moves through pages; those two
+are the CLI's own, not filters.
+
+**`hirify filter guide` is the method and vocabulary, and the only source for either.** Do not guess
+criterion names or values. The final search refuses an unknown criterion, while a misspelt value
+can return an empty list that looks like an honest "nothing matches". If a server does not serve
+the guide, it says so; then ask the user what to filter on.
+
+1. Read `hirify filter guide` and build a draft from the user's request or profile.
+2. Run `hirify api call filters.preview --data '{"filters":{...},"mode":"compact","per_page":20}'`.
+3. Inspect cards and `meta.total`; refine and preview again if they are empty, broad or irrelevant.
+4. Run `hirify vacancy search` with the validated criteria.
+
+## Applying
+
+Two cases, two commands:
+
+- **Hosted on Hirify** -> `hirify vacancy apply <slug>` sends the application through Hirify.
+- **From somewhere else** -> `hirify vacancy reveal <slug>` gives the link or contact, and the
+  application goes there rather than through Hirify. `vacancy apply` refuses these and says so.
+  What you do with that destination is between you and your user.
+
+- **Ask first, every time, and show what you are about to send.** An application cannot be taken
+  back. Never apply to a list on a single "yes".
+- **Never invent the cover letter.** Draft it from what the user actually said about themselves and
+  show them the draft; if they gave you nothing, ask rather than fill the gap.
+- **Never choose the profile** when the user has several: `hirify profile list` lists them. With
+  exactly one profile it is chosen automatically.
+- After a successful apply, say it was sent and stop. Nobody follows up: the recruiter replies where
+  they choose to, and Hirify does not track it.
+
+## Saved searches and delivery
+
+These change the user's account, so the same rule holds: propose, get a yes, then do it.
+
+```bash
+hirify feed create "<name>" --filters '<json>'   # criteria: hirify filter guide
+hirify feed deliver <id> --telegram | --no-telegram | --webhook <id> | --no-webhook
+hirify webhook list
+hirify webhook create "<name>" <url>
+```
+
+`--filters` takes the same criteria as the site's filter form; read `hirify filter guide` first.
+Creating a delivery endpoint returns a **secret shown once**: give it to the user immediately to
+store, because it signs every delivery and cannot be shown again.
+
+## Telling Hirify something is broken
+
+`hirify feedback send <bug|feature> "<title>" --body "<text>" [--vacancy <slug>]` sends a report,
+free. Ask first, send the user's words rather than your own, and report that it was passed on: it
+gives a ticket number or says there is none yet, nothing writes back, and no fix or date is promised.
+
+## When something goes wrong
+
+**The message you were given is the truth; this is a map of the kinds, not strings to match.** Every
+failure exits non-zero and writes one line to stderr. Read that line and tell the user what it says.
+
+- **Not signed in**: ask the user to run `hirify login` (it opens a browser and needs a person -
+  never run it yourself). On a server with no browser: `hirify auth <key>`, key from
+  hirify.me/account/api-access.
+- **Sign-in no longer good** (401): expired or revoked. Ask the user to run `hirify login` again.
+- **No access** (403): the sign-in is missing an ability, or the plan does not cover agent access.
+  Abilities are fixed at sign-in, so a user who signed in before an ability existed signs in again.
+- **A budget or the pace** (429): a metered action is used up - reveals, vacancy opens, or applies -
+  or commands came too fast. The message names which; feeds and search keep working. What is left:
+  `hirify account show`.
+- **A refusal naming a length or a value** comes from the server: shorten what it named and send
+  again, do not argue with it or assume a bound.
+- **`hirify <noun> has no verb "..."`**: the name does not exist and the message lists the verbs that
+  noun takes. Read the list rather than guessing again.
+
+## When no command fits
+
+`hirify api call <capability-id> --data '<json>'` runs a capability by its id and prints the answer
+as it comes back, so a job with no named command is a detour, not a dead end. `hirify --help` and
+the server's own catalogue name the capabilities.
+
+Reach for a named command first where one exists: it says what a call costs and what a refusal means,
+and this one cannot. It will spend a reveal or send a real application just as readily, so the same
+rule holds - ask the user before anything that sends, saves or configures.

package/plugins/jobhunt-kit/references/hirify/reference.md

@@ -0,0 +1,286 @@
+# hirify CLI reference
+
+Written for an agent. Every command, what it costs, what it answers, and how it refuses.
+
+Commands are a noun and a verb: the noun is the thing you are working with, the verb is what you do
+to it. `hirify <noun>` on its own lists the verbs that noun takes. `login`, `logout`, `auth` and
+`intro` stay single words: they are not operations on a thing.
+
+**This file describes the CLI, not the state of Hirify.** It is installed with the skill and never
+updated afterwards, so it names no filter, no limit and no number that our side can change. Those
+come from commands: `hirify filter guide` for filters, `hirify account show` for what is left,
+`hirify account show --json` for the plan and the limits. Where this file would have quoted one, it
+names the command instead.
+
+Add `--json` to any command to get the server's payload verbatim instead of the text below.
+`--fields a,b` narrows a compact answer to the fields you name and never adds one the answer did not
+carry. Parse `--json`; do not parse the text, it is written for a person to read.
+
+**Exit codes are stable.** `0` is success, `1` an ordinary error, and `2` means this Hirify speaks a
+newer manifest than your CLI can read - update the CLI. Every failure also writes one line to stderr
+beginning with `hirify: `. Branch on the code rather than on the message text.
+
+Set `HIRIFY_DEBUG=1` in front of a command to also get the server's own answer on stderr. Use it
+when you need to report a problem; the normal output never contains raw payloads.
+
+## Cost model
+
+| Command | Cost | Reversible |
+|---|---|---|
+| `account show`, `feed list`, `feed show`, `vacancy search`, `profile list`, `webhook list` | free: they spend nothing | reading only |
+| `vacancy read` | 1 vacancy open from a generous daily allowance, repeats the same day are free | reading only |
+| `vacancy reveal` | 1 reveal, repeats on the same vacancy are free | reading only |
+| `vacancy apply` | counts against a daily allowance of its own | **no**: a real application reaches a real person |
+| `feed create`, `feed deliver`, `webhook create` | free | changes the user's account |
+| `feedback send` | free | a ticket is filed |
+| `filter guide` | free: it spends nothing | reading only |
+| `api call` | whatever the capability it calls costs | whatever that capability does |
+
+Free is not unlimited: every command is rate-limited, reading more loosely than searching. A burst
+answers `429` and names the seconds to wait. The numbers are the server's and change without this
+file: `hirify account show --json`, block `limits`.
+
+Three budgets run out, and they are separate. Vacancy opens are the allowance `vacancy read` draws
+on. Reveals are the scarce one. Applications have a daily allowance of their own - `vacancy apply`
+is not the free step it looks like. All three are in `hirify account show`, and in
+`hirify account show --json` under
+`quota.read`, `quota.reveal` and `quota.apply`.
+
+**No number for any of them is written in this file.** Each block carries `limit`, `used` and
+`remaining` as the server currently has them; that is the only place they are true, and this file
+outlives every change to them.
+
+## Signing in
+
+`hirify login` opens a browser and needs a person. Never run it yourself: ask the user to run it.
+It stores access in `~/.config/hirify/auth.json` (mode 600) and renews it without asking again.
+`hirify logout` forgets it. On CI or a server: `hirify auth <key>`, or `HIRIFY_KEY` in the
+environment, which wins over a stored sign-in.
+
+Permissions are fixed when the user signs in and cannot be added afterwards. A 403 naming a missing
+permission means the user signed in before that permission existed: they have to run `hirify login`
+again.
+
+## Reading
+
+```bash
+hirify account show
+hirify feed list
+hirify feed show <id> [--limit N] [--page N]
+hirify vacancy search "<phrase>" [--<criterion> <value>]... [--limit N] [--page N]
+```
+
+`account show` reports the plan, the reveals left, the vacancy opens left today, the applications
+left today, and reveal usage over 7 and 30 days. Check it before spending any of the three. The
+allowances come as one number each, not as a fraction.
+
+`feed list` lists saved searches as `<id> <name>`, with `(off)` for an inactive one. `feed show
+<id>` returns that feed's vacancies, using the criteria saved in the feed.
+
+`vacancy search` is a conduit. The words are the phrase; every option is forwarded to the API under
+the name you gave it, so the criteria are the server's and this CLI holds no copy of them to fall
+behind. `--limit` is the page size and arrives as the API's `per_page`; `--json` steers the CLI and
+is never sent. An option repeated is joined with a comma, which is how the site sends a criterion
+with several values.
+
+**The criteria and the method come from `hirify filter guide`, and only from there.** Do not guess
+names or values. The final search refuses an unknown criterion, while a misspelt value can return
+an empty list that looks like an honest answer.
+
+Both `feed show` and `vacancy search` page with `--page N`. The last line of a list says which page
+you are on and offers the next one when there may be another.
+
+Vacancy cards print as:
+
+```
+<slug>
+  <title> · <company or "company hidden">
+  [<remote> · <format> · <employment> · <english> · <salary> · verified]
+```
+
+Cards never carry contacts. `company hidden` means the name is revealed by `vacancy reveal`, not
+that the field is broken.
+
+## filter guide: what search can filter on
+
+```bash
+hirify filter guide
+```
+
+Prints the filter guide the server writes: which criteria search accepts, what their values are,
+and the method for turning what a person wants into a filter that works. Free, and it needs
+`agent:read` like the other reading commands.
+
+The server derives it from the same source the site's own search reads, so it cannot fall behind
+the search. That is the whole point: nothing in this package writes filter names down, because a
+list written here goes stale silently and an agent acts on it without knowing.
+
+The guide requires a preview before a filter is used. For the CLI, invoke the preview capability
+through the generic command:
+
+```bash
+hirify api call filters.preview --data '{"filters":{"search":"product manager"},"mode":"compact","per_page":20}'
+```
+
+Inspect the cards and `meta.total`, refine when needed, and only then run `hirify vacancy search`
+with the same criteria. Preview and search use the same search implementation.
+
+`--json` gives `{"guide": "<text>"}`. The text is written for a model to read, so pass it through
+rather than summarising it.
+
+A server that does not serve the guide yet answers plainly: `this Hirify server does not serve the
+filter guide yet.` Then the criteria have to come from the user, not from a guess.
+
+## vacancy read: one vacancy in full
+
+```bash
+hirify vacancy read <slug>
+```
+
+The card plus everything else the vacancy page shows: area, grade, skills, location, when it was
+posted, the page address, and the description as text. This is the command that decides fit, and it
+is deliberately cheap.
+
+It costs one vacancy open from the daily allowance, and the same vacancy read again the same day
+costs nothing. The output states whether an open was used and how many are left.
+
+The last line before that says which way to apply:
+
+- `Apply on Hirify: hirify vacancy apply <slug>` - the vacancy is hosted here.
+- `Where to apply: hirify vacancy reveal <slug> (uses 1 reveal)` - it came from elsewhere, so the
+  application goes to that destination rather than through Hirify. Take this from `vacancy read`
+  rather than finding out from a refusal on `vacancy apply`.
+
+Contacts, the apply destination and where the vacancy came from are never in this answer. That is
+what `vacancy reveal` is for.
+
+With `--json`, `data.description` is HTML (`data.description_format` says so) and the text output is
+the same content flattened for a terminal. `charged` and `quota` sit next to `data`.
+
+Refusals: `there is no vacancy with that slug.`, and, when the day's opens are spent, `you have
+opened as many vacancies today as the daily allowance covers.` - feeds and search still work then,
+and so does any vacancy already read today.
+
+## vacancy reveal: where to apply
+
+```bash
+hirify vacancy reveal <slug>
+```
+
+Spends 1 reveal and returns the company, its LinkedIn page when known, and one or more
+contacts: an address, a form URL, or a link. Revealing the same vacancy again returns the same thing
+and spends nothing, so a repeat is safe. The output states whether a reveal was used and how many
+are left.
+
+Shortlist with `vacancy read` first. A reveal spent at random is spent.
+
+## vacancy apply: only on Hirify
+
+```bash
+hirify profile list
+hirify vacancy apply <slug> [--profile <id>] [--cover "<text>"]
+```
+
+`profile list` lists what the user can apply with: `<profile_id> <name> [status · incomplete]`.
+
+`vacancy apply` sends an application through Hirify. **Ask the user first, every time, and show
+what you are sending.** It cannot be undone, and it counts against a daily allowance of its own:
+`hirify account show` reports what is left, and `hirify account show --json` carries it as
+`quota.apply` with `limit`, `used` and `remaining` as the server currently has them.
+
+- `--profile` is required when the user has more than one profile. With exactly one, it is chosen
+  automatically. Never guess between several.
+- `--cover` is optional. There is a length ceiling and the server owns it: if the letter is too
+  long, the answer says so. Write it from what the user told you and show them the draft first.
+
+Answers:
+
+- success: `Applied. Application <id>, status <status>.` Nothing follows up: the recruiter replies
+  where they choose to.
+- `there is no vacancy with that slug.`
+- a refusal in the server's own words, which covers archived, flagged, someone else's profile, and
+  **vacancies not hosted on Hirify**. For those, use `vacancy reveal` and apply at the destination it
+  returns.
+- `the application could not be sent right now.` means our side failed, not the user's data.
+
+## Saved searches and delivery
+
+```bash
+hirify feed create "<name>" [--filters '<json>'] [--telegram|--no-telegram] [--webhook <id>]
+hirify feed deliver <id> [--telegram|--no-telegram] [--webhook <id>|--no-webhook]
+hirify webhook list
+hirify webhook create "<name>" <url>
+```
+
+These change the user's account. Propose, get a yes, then run them.
+
+`--filters` takes the same criteria the site's filter form produces, as JSON, and the names come
+from `hirify filter guide`. Omitting it saves a feed with no criteria, which means "send me
+everything" and is legal.
+
+`webhook create` answers with the endpoint and a **secret shown once**. Hand it to the user
+immediately and tell them to store it: it signs every delivery and cannot be shown again.
+
+## feedback send
+
+```bash
+hirify feedback send <bug|feature> "<title>" --body "<text>" [--vacancy <slug>]
+```
+
+Both a title and a body are required, and the CLI says so before sending anything. Their lengths
+are the server's rule, not the CLI's: too short or too long comes back as the server's own sentence
+naming which. Ask the user before sending and send their words. The answer gives a ticket number,
+or says there is no number yet. There is no page to open, nothing writes back to the user, and no
+reply, fix or date is promised. Report that it was passed on and stop there.
+
+Refusals: too many reports in a short time (with the wait in seconds), the channel being off, or the
+report not being accepted.
+
+## api call: any capability by its id
+
+```bash
+hirify api call <capability-id> [--data '<json>'] [--fields a,b] [--json]
+```
+
+Invokes any capability Hirify lists in its manifest, by its id, and prints the answer. It is here so
+that a job this CLI has no named command for is a detour rather than a dead end. The ids are the
+ones the manifest publishes; the named commands above cover the common ones, and this reaches the
+rest.
+
+```bash
+hirify api call account.status
+hirify api call vacancies.search --data '{"search":"go","per_page":5}'
+hirify api call feeds.create --data '{"name":"Senior Go","filters":{}}'
+```
+
+- Inputs go in `--data` as one JSON object. Each value is routed where the manifest places it: into
+  the path, the query string, or the body. A `--data` that is not JSON is refused before anything is
+  sent, and a capability the manifest does not list is named as unknown without a request being made.
+- The answer is rendered compactly by default, so it reads without a parser: a vacancy card shows the
+  same shortlist fields `vacancy search` prints, and any other shape shows the fields the server
+  returned, one per line. `--fields a,b` narrows that to the fields you name.
+- `--json` gives the raw canonical answer instead, refusals included, so what you parse is the
+  server's own payload rather than a sentence of ours. On a refusal the raw answer is printed and the
+  exit code is non-zero.
+
+**Prefer a named command where one exists.** This one carries none of what they know: it will not
+tell you that a call costs a reveal, and it will send a real application as readily as
+`vacancy apply` would. The permission rules do not change: ask the user before anything that sends,
+saves or configures.
+
+## Failure modes worth knowing
+
+| Message | What it means | What to do |
+|---|---|---|
+| `you are not signed in yet` | no stored access | ask the user to run `hirify login` |
+| `your sign-in is no longer valid` | the session expired past renewal | ask the user to run `hirify login` |
+| `the key was not accepted (401)` | a manual key was revoked or truncated | new key from the account page |
+| `no access (403)` | missing permission, or the plan does not cover agent access | sign in again, or check the plan |
+| `you have no reveals left right now` | the reveal budget is spent | reading still works; `hirify account show` has what is left |
+| `you have sent as many applications today...` | the daily allowance for applying is spent | reading and revealing still work; `hirify account show` has what is left |
+| `you have opened as many vacancies today...` | the day's vacancy opens are spent | feeds, search and anything already read today still work |
+| `too many requests in a short time` | asking faster than the API allows | wait the seconds it names, then carry on |
+| `something went wrong on our side` | our fault, not the request | retry in a minute |
+| an empty list from a filtered search | usually a criterion name or value that does not exist | check the name against what the server accepts, do not keep guessing |
+| `the network seems to be unavailable` | no connection | retry |
+| `hirify <noun> has no verb "..."` | a command name this CLI does not have | the message lists the verbs that noun takes; read it rather than guessing again |

package/plugins/jobhunt-kit/references/matching.md

@@ -0,0 +1,28 @@
+# Сопоставление вакансии с профилем
+
+Проверять полное описание. Сначала ограничения, затем предпочтения. Оценка — помощь
+в принятии решения, не предсказание ответа работодателя. Не сравнивать кандидатов.
+
+Для каждого обязательного условия из профиля и вакансии записать:
+`requirement`, `result` (pass/fail/unknown), `evidence` (цитата/путь к факту и объяснение).
+Обязательно проверить ограничения remote по стране, уровень/обязанности, рабочий
+график, языки, право на работу по словам кандидата, обязательные навыки, исключения
+компаний и компенсацию, если она является жёстким условием.
+Не переводить gross в net или валюты без явных допущений и текущего источника курса.
+Отсутствующий диапазон зарплаты — unknown, пока кандидат не разрешил такие вакансии.
+
+- `suitable`: все обязательные условия подтверждены; предпочтения могут совпадать частично.
+- `review`: есть значимый unknown или неоднозначное обязательное требование.
+- `rejected`: явное нарушение обязательного условия или исключение кандидата.
+- `unreviewed`: только карточка; не входит в число найденных подходящих вакансий.
+
+В reasons объяснить сильные совпадения, пробелы и компромиссы. Для ранжирования
+подходящих использовать предпочтения кандидата и актуальность, без выдуманного
+универсального процента. Unknown нельзя превратить в pass ради заполнения пятёрки.
+
+`target=5` — максимум новых suitable за запуск. Карточки review показывать отдельно;
+старые вакансии и повторные страницы не считать новыми. До поиска снять список
+существующих ID; put возвращает is_new для первой записи, а обновление карточки
+полным текстом уже даёт false. Поэтому вести множество «новые в этом запуске».
+Остановиться при target, конце выдачи, повторении страницы, исчерпании бюджета
+или времени. Если найдено меньше пяти, назвать конкретную причину.