Leave out titles by phrase: an exclude gate mode and a title gate field
A role whose title holds one of the agent's phrases as whole words is gated with the phrase as its reason, a favourite's too. The agent form has a Leave out titles line under Where. function = sales could not do it, since the classifier files Solutions Engineer and pre-sales under sales. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
4e827665dd
commit
8c6ea0ffb6
8 files changed
+116
-21
No files matched your search
+13
-7
@@ -9,6 +9,8 @@ good for a given search. For each agent:
|
||||
column filled for at least one, is gated ("none of
|
||||
country DK / remote remote")
|
||||
prefer gates `weight` when the role matches, 0 when it does not
|
||||
exclude gates a role that matches one of the values keeps its row, with
|
||||
score 0 and the value ("title account executive")
|
||||
|
||||
A gate rejects on evidence, never on absence: a role whose column is empty
|
||||
is not gated by it. `extract` is what fills an empty column, and it reads
|
||||
@@ -29,7 +31,8 @@ roles out of extract's reach for good.
|
||||
|
||||
Every term is 0..1. The score is the weighted sum over the sum of the weights
|
||||
(the agent's four and its prefer gates'), so it stays 0..1. A favourite
|
||||
company (`affinity = 2`) skips the `any` group but not the `require` gates, and
|
||||
company (`affinity = 2`) skips the `any` group but not the `require` or
|
||||
`exclude` gates, and
|
||||
is scored like any other company with its affinity term at 1: nothing puts
|
||||
its roles above a better fit. A hidden one (`-1`) is not scored at all. A
|
||||
role with no vector is scored without `fit` and `taste`, unless `fit` is all
|
||||
@@ -156,14 +159,17 @@ def _reason(gate: Gate) -> str:
|
||||
|
||||
|
||||
def failed_gates(candidate: Candidate, gates: Sequence[Gate]) -> list[str]:
|
||||
"""Why this role is gated, as reasons: every require gate it fails, and
|
||||
the `any` group when it matches none of them. A gate with an empty column
|
||||
(state -1) neither passes nor fails, so the group fails only when some
|
||||
member had evidence. A favourite company's roles skip the `any` group but
|
||||
not the require gates, so a star widens a search to a company's roles
|
||||
within e.g. Europe, not to the whole world."""
|
||||
"""Why this role is gated, as reasons: every require gate it fails, every
|
||||
exclude gate it matches, and the `any` group when it matches none of them.
|
||||
A gate with an empty column (state -1) neither passes nor fails, so the
|
||||
group fails only when some member had evidence. A favourite company's
|
||||
roles skip the `any` group but not the require and exclude gates, so a
|
||||
star widens a search to a company's roles within e.g. Europe, not to the
|
||||
whole world, and not to the titles the agent leaves out."""
|
||||
states = list(zip(gates, candidate.gates, strict=True))
|
||||
reasons = [_reason(g) for g, state in states if g.mode == "require" and state == 0]
|
||||
reasons += [f"{g.field} {g.values[state - 1]}" for g, state in states
|
||||
if g.mode == "exclude" and state > 0]
|
||||
group = [(g, state) for g, state in states if g.mode == "any"]
|
||||
if candidate.affinity != 2 and group and not any(state == 1 for _, state in group) \
|
||||
and any(state == 0 for _, state in group):
|
||||
|
||||
+12
-5
@@ -1167,21 +1167,26 @@ class Application(Model):
|
||||
|
||||
#: The role columns a gate can name. `company` matches on the company key;
|
||||
#: `place` takes the Place filter's tokens (`app.places`: `country:DK`,
|
||||
#: `region:skane`, `place:malmo`, bare text a `place:`) on whole words; the rest are
|
||||
#: `region:skane`, `place:malmo`, bare text a `place:`) on whole words; `title`
|
||||
#: matches a value as whole words anywhere in the title, folded as `title_key`
|
||||
#: folds it, so `account executive` finds "Enterprise Account Executive, UK"
|
||||
#: and `data engineer` does not find "Data Engineering Manager"; the rest are
|
||||
#: case-insensitive equality, except `salary_min` (at least the value) and
|
||||
#: `languages` (every language the role requires is one of the values).
|
||||
GateField = Literal["place", "country", "remote", "seniority", "function", "salary_min",
|
||||
"currency", "permit", "languages", "company"]
|
||||
"currency", "permit", "languages", "company", "title"]
|
||||
GATE_FIELDS: tuple[str, ...] = get_args(GateField)
|
||||
|
||||
GateMode = Literal["require", "any", "prefer"]
|
||||
GateMode = Literal["require", "any", "prefer", "exclude"]
|
||||
|
||||
|
||||
class Gate(Model):
|
||||
"""One condition of an agent. `require` gates a role that fails it (the
|
||||
row is kept with the reason); the `any` gates together are one group a
|
||||
role must match at least one of ("in Denmark, or remote"); `prefer` adds
|
||||
`weight` to its score when it matches. A gate rejects on evidence only: a
|
||||
`weight` to its score when it matches; `exclude` gates a role that matches
|
||||
any of its values ("title account executive"), a favourite's too. A gate
|
||||
rejects on evidence only: a
|
||||
role whose column is empty is not rejected, since `extract` fills the
|
||||
column later for the roles that rank, and only for those."""
|
||||
|
||||
@@ -1297,7 +1302,9 @@ class Agent(Model):
|
||||
class Candidate(Model):
|
||||
"""What scoring reads about one open role for one agent: its posted
|
||||
date (for `recency`), its company's affinity for that agent, and per
|
||||
gate `1` match, `0` no match, `-1` the column is empty."""
|
||||
gate `1` match, `0` no match, `-1` the column is empty. An `exclude`
|
||||
gate's match is the position of the first value it matched, from 1, so
|
||||
the reason can name it."""
|
||||
|
||||
uid: str
|
||||
posted_at: str
|
||||
|
||||
+13
-4
@@ -39,8 +39,8 @@
|
||||
"HU", "IE", "IT", "LV", "LT", "LU", "MT", "NL", "PL", "PT", "RO", "SK", "SI", "ES", "SE",
|
||||
"IS", "LI", "NO", "GB", "CH", "EU"];
|
||||
const FIELDS = ["place", "country", "remote", "seniority", "function", "salary_min",
|
||||
"currency", "permit", "languages", "company"];
|
||||
const MODES = [["require", "must"], ["any", "one of"], ["prefer", "prefer"]];
|
||||
"currency", "permit", "languages", "company", "title"];
|
||||
const MODES = [["require", "must"], ["any", "one of"], ["prefer", "prefer"], ["exclude", "not"]];
|
||||
const HYBRID_WEIGHT = 0.05;
|
||||
|
||||
/** @type {object[]} every agent, as the server lists them */
|
||||
@@ -227,11 +227,14 @@
|
||||
const must = of("require").map(phrase);
|
||||
const prefer = of("prefer").map((g) => phrase(g).replace(/^with /, ""));
|
||||
if (where.hybrid) prefer.unshift("hybrid");
|
||||
const not = of("exclude").map(phrase);
|
||||
const sentences = [];
|
||||
const any = whereSentence(where, of("any"));
|
||||
if (any) sentences.push(any);
|
||||
if (must.length) sentences.push(`Only roles ${must.join(" and ")}.`);
|
||||
if (prefer.length) sentences.push(`Prefers ${prefer.join("; ")}.`);
|
||||
if (where.titles) sentences.push(`Leaves out titles with ${orList(where.titles.values.map((t) => `“${t}”`))}.`);
|
||||
if (not.length) sentences.push(`Leaves out roles ${not.join(" or ")}.`);
|
||||
return sentences.join(" ");
|
||||
}
|
||||
|
||||
@@ -497,7 +500,7 @@
|
||||
// that is Europe and the countries line exactly, and only with Remote
|
||||
// ticked; any other must on country is a row, and Remote reads anywhere.
|
||||
function distribute(gates) {
|
||||
const where = { countries: null, places: null, remote: null, europe: null, hybrid: null };
|
||||
const where = { countries: null, places: null, remote: null, europe: null, hybrid: null, titles: null };
|
||||
const rest = [];
|
||||
const musts = [];
|
||||
const plain = (g) => g.weight === undefined || g.weight === 1;
|
||||
@@ -512,6 +515,7 @@
|
||||
else if (g.field === "remote" && g.mode === "any" && plain(g) && only(g, "remote")) slot = "remote";
|
||||
else if (g.field === "place" && g.mode === "any" && plain(g)) slot = "places";
|
||||
else if (g.field === "remote" && g.mode === "prefer" && only(g, "hybrid")) slot = "hybrid";
|
||||
else if (g.field === "title" && g.mode === "exclude" && plain(g)) slot = "titles";
|
||||
if (slot && !where[slot]) where[slot] = g;
|
||||
else rest.push(g);
|
||||
}
|
||||
@@ -561,7 +565,9 @@
|
||||
const { where, rest } = distribute(row ? row.gates : []);
|
||||
const countries = countryInput(where.countries ? where.countries.values : []);
|
||||
const places = wordInput(where.places ? where.places.values : [], "Add a town");
|
||||
const titles = wordInput(where.titles ? where.titles.values : [], "account executive");
|
||||
const terms = wordInput(row ? row.fetch_terms || [] : [], "machine learning, data science");
|
||||
$("#a-titles", f).replaceWith(titles.node);
|
||||
$("#a-terms", f).replaceWith(terms.node);
|
||||
$("#a-countries", f).replaceWith(countries.node);
|
||||
$("#a-towns", f).replaceWith(places.node);
|
||||
@@ -601,7 +607,8 @@
|
||||
});
|
||||
|
||||
// The gates the Where block says, in the order the starter agents have
|
||||
// them: the must on country, the lines, then hybrid.
|
||||
// them: the must on country, the lines, then hybrid; and the titles left
|
||||
// out, the block under it.
|
||||
function whereGates() {
|
||||
const out = [];
|
||||
const within = countries.values();
|
||||
@@ -615,6 +622,8 @@
|
||||
if ($("#a-hybrid", f).checked) {
|
||||
out.push({ field: "remote", values: ["hybrid"], mode: "prefer", weight: Number($("#a-hybrid-weight", f).value) });
|
||||
}
|
||||
const left = titles.values();
|
||||
if (left.length) out.push({ field: "title", values: left, mode: "exclude" });
|
||||
return out;
|
||||
}
|
||||
// The gates Save sends: the Where block's, then the rows. The sentence
|
||||
|
||||
+2
-1
@@ -1223,7 +1223,8 @@ table.applications td[data-label="Saved"] { white-space: nowrap; color: var(--di
|
||||
border-radius: .3rem; padding: .35rem .5rem;
|
||||
}
|
||||
/* The fieldsets that hold rows: a column, the Add button under the rows. */
|
||||
.agent-form fieldset.prompts, .agent-form fieldset.where, .agent-form fieldset.terms,
|
||||
.agent-form fieldset.prompts, .agent-form fieldset.where, .agent-form fieldset.titles,
|
||||
.agent-form fieldset.terms,
|
||||
.agent-form fieldset.rules {
|
||||
display: flex; flex-direction: column; align-items: stretch; gap: .5rem; min-width: 0;
|
||||
border: 1px solid var(--line); border-radius: .3rem;
|
||||
|
||||
+16
-4
@@ -219,6 +219,13 @@ def _gate_sql(gate: Gate, gaz: places.Gazetteer) -> tuple[str, str, list[Any]]:
|
||||
if gate.field == "place":
|
||||
match, params = _places_sql(values, gaz, table="r")
|
||||
return "r.place = ''", match, params
|
||||
if gate.field == "title":
|
||||
# Whole words of the folded title: " account executive " inside
|
||||
# " enterprise account executive uk ". A fold drops `%` and `_`, so a
|
||||
# value cannot smuggle a LIKE wildcard in.
|
||||
words = [f"% {title_key(v)} %" for v in values if title_key(v)]
|
||||
match = " OR ".join("(' ' || r.title_key || ' ') LIKE ?" for _ in words) or "0"
|
||||
return "r.title_key = ''", f"({match})", words
|
||||
if gate.field == "company":
|
||||
keys = [company_key(v) for v in values]
|
||||
return ("r.company_key = ''",
|
||||
@@ -1830,10 +1837,15 @@ class Store:
|
||||
params: list[Any] = []
|
||||
gaz = self.gazetteer()
|
||||
for n, gate in enumerate(gates):
|
||||
empty, match, values = _gate_sql(gate, gaz)
|
||||
columns.append(
|
||||
f"CASE WHEN {empty} THEN -1 WHEN {match} THEN 1 ELSE 0 END AS g{n}")
|
||||
params += values
|
||||
# An exclude gate says which of its values matched: one WHEN each.
|
||||
parts = ([gate.model_copy(update={"values": [v]}) for v in gate.values]
|
||||
if gate.mode == "exclude" else [gate])
|
||||
whens = []
|
||||
for k, part in enumerate(parts, 1):
|
||||
empty, match, values = _gate_sql(part, gaz)
|
||||
whens.append(f"WHEN {match} THEN {k}")
|
||||
params += values
|
||||
columns.append(f"CASE WHEN {empty} THEN -1 {' '.join(whens)} ELSE 0 END AS g{n}")
|
||||
select = ", ".join(["r.uid", "r.posted_at",
|
||||
"COALESCE(ac.affinity, 0) AS affinity", *columns])
|
||||
rows = self._rows(
|
||||
|
||||
@@ -49,6 +49,14 @@
|
||||
<span class="hint">This one ranks rather than filters: a hybrid role gains a little.</span>
|
||||
<p id="a-where-sum" class="where-sum" role="status"></p>
|
||||
</fieldset>
|
||||
<fieldset class="titles">
|
||||
<legend>Which titles to leave out?</legend>
|
||||
<div class="where-line">
|
||||
<span>Leave out titles with</span>
|
||||
<div id="a-titles"></div>
|
||||
</div>
|
||||
<span class="hint">Separate phrases with a comma or Enter. A phrase matches whole words anywhere in the title, whatever the case: <code>account executive</code> takes "Enterprise Account Executive, UK", and <code>data engineer</code> leaves "Data Engineering Manager" alone. A shorter phrase takes more: <code>sales</code> takes Sales Engineer too. It applies to liked companies as well. A role left out keeps its row, and Show gated on Roles lists it with the phrase that took it.</span>
|
||||
</fieldset>
|
||||
<fieldset class="terms">
|
||||
<legend>What big boards send</legend>
|
||||
<div class="where-line">
|
||||
|
||||
Reference in new issue
Block a user