@rackbops/plugin-tracker 0.31.2 → 0.31.4

package/README.md

@@ -559,6 +559,11 @@ It is served under `/tracker/api/v1/` on the same origin as the web area, and on
 `TRACKER_WEB_URL` is set. Every write goes through the same functions as the web editor and the
 slash commands -- the same fields, defaults, limits, caps and messages -- in the same write queue.
 
+The Claude in Chrome route (#125) is one such program: this repo's `clerk-browser-search` skill
+(`.claude/skills/clerk-browser-search/SKILL.md`) searches eBay and BoardGameGeek in the owner's own
+Chrome, looking only, and sends listings to inbox watches and pages to research requests through
+`scripts/clerk-browser.ts`, which reads the Access service token and the tracker token from files.
+
 **Tokens.** Make one on the web area's `/tokens` page (linked from Settings): a name, and an expiry
 of 30, 90 (the default) or 365 days -- every token expires. The token -- `trk_` and 43 characters --
 is sent to you once, by Discord DM from the bot; it never appears in any web page or response, and

package/dist/plugin.js

@@ -2842,19 +2842,19 @@ var REVIEW_SCHEMA = {
     },
     answer: {
       ...ANSWER_SCHEMA,
-      description: "The answer to send: the draft unchanged on approve, corrected on revise."
+      description: "The corrected answer, on revise only; left out on approve and reject."
     }
   },
   required: ["verdict", "problems"]
 };
-function parseReview(value) {
+function parseReview(value, draft) {
   if (!isObj2(value) || typeof value.verdict !== "string")
     return null;
   const verdict = VERDICTS.includes(value.verdict) ? value.verdict : null;
   if (!verdict)
     return null;
   const problems = (Array.isArray(value.problems) ? value.problems : []).filter((p) => typeof p === "string").map((p) => clean(p, MAX_PROBLEM_CHARS, true)).filter((p) => p.length > 0).slice(0, MAX_PROBLEMS);
-  const answer = parseAnswer(value.answer);
+  const answer = parseAnswer(value.answer) ?? (verdict === "approve" ? draft ?? null : null);
   if (verdict !== "reject" && !answer)
     return null;
   return { verdict, problems, answer: verdict === "reject" ? null : answer };
@@ -3094,6 +3094,57 @@ function sourcesExpiry(now, deadline) {
   };
 }
 
+// node_modules/@rackbops/docket-types/dist/research-web.js
+var FIRECRAWL_TOOLS = [
+  "mcp__firecrawl__firecrawl_search",
+  "mcp__firecrawl__firecrawl_scrape"
+];
+var WEB_ALLOWED_TOOLS = [...DEFAULT_ALLOWED_TOOLS, ...FIRECRAWL_TOOLS];
+function firecrawlLines() {
+  return [
+    "Read pages with WebFetch first. When a page refuses WebFetch (a 403, a block, a CAPTCHA " + "or challenge page), read it with `firecrawl_scrape` instead. Always pass " + '`proxy: "basic"` to it; never "stealth", "enhanced" or "auto", and nothing else that ' + "disguises the request. Scrape one page at a time: never several pages of the same site " + "in parallel. Never pass any eBay URL to any tool, Firecrawl included. You may use " + "`firecrawl_search` as you would web search. If Firecrawl is refused too, the page did " + "not open: handle it as a page that refused you, as above."
+  ];
+}
+function firecrawlChecks() {
+  return [
+    "- To open a source, use WebFetch first; when a page refuses it (a 403, a block, a CAPTCHA), " + 'read it with `firecrawl_scrape`, always with `proxy: "basic"` (never "stealth", ' + '"enhanced" or "auto", nothing that disguises the request), one page at a time, never ' + "several pages of one site in parallel. Never pass any eBay URL to any tool. You may use " + "`firecrawl_search` as you would web search."
+  ];
+}
+var BGG_CATEGORIES = [
+  { name: "Strategy", familyId: 5497 },
+  { name: "Family", familyId: 5499 },
+  { name: "Thematic", familyId: 5496 },
+  { name: "Party", familyId: 5498 },
+  { name: "Abstract", familyId: 4666 },
+  { name: "Customizable", familyId: 4667 },
+  { name: "Children's", familyId: 4665 },
+  { name: "Wargames", familyId: 4664 }
+];
+function bggCategoryUrl(familyId, year) {
+  return "https://boardgamegeek.com/search/boardgame?sort=bggrating&advsearch=1" + `&range[yearpublished][min]=${year}&range[yearpublished][max]=${year}` + `&range[numvoters][min]=30&nosubtypes[0]=boardgameexpansion&familyids[0]=${familyId}`;
+}
+function categoryNames() {
+  const names = BGG_CATEGORIES.map((c) => c.name);
+  return `${names.slice(0, -1).join(", ")} and ${names.at(-1)}`;
+}
+function categoryLines(second = false) {
+  return [
+    'When the question asks about categories (or "each of the major" kinds of something) and ' + "the best source defines its own categories, use that site's categories and say so" + (second ? "" : " in the summary") + "; do not invent genres, and do not say that no source defines them. For " + `board games these are BoardGameGeek's ${BGG_CATEGORIES.length} category rankings: ` + `${categoryNames()}. A category with no entry that qualifies is answered "none yet", ` + "with the reason; never leave it out." + (second ? " In this update, the summary names any category whose pick changed." : ` ${COMPACT_RUN}`)
+  ];
+}
+var COMPACT_RUN = `The summary itself names every category's pick in one compact run, such as "Strategy: X; ` + `Family: Y; ...; Children's: none yet (no 2026 game has 30 ratings)", so none is lost when ` + "a long answer is cut; the findings carry each pick's source.";
+function bggSearchHint() {
+  const ids = BGG_CATEGORIES.map((c) => `${c.name} ${c.familyId}`).join(", ");
+  return [
+    "A hint you may use: a BoardGameGeek advanced search shows one category for one year, such " + `as ${bggCategoryUrl(5497, 2026)} (Strategy, 2026). ` + `Change the year and the \`familyids[0]\` value for the category: ${ids}. These ids were ` + "seen on the site, not documented by it: if one shows the wrong category, use that " + "category's own ranking page."
+  ];
+}
+function categoryChecks() {
+  return [
+    "- Where the question asks about categories and the best source defines its own (for " + `board games, BoardGameGeek's ${BGG_CATEGORIES.length}: ${categoryNames()}), the answer ` + "uses them and says so. An answer that invents its own categories, or says no source " + "defines them, while the source does, is `revise`d onto the source's categories. A " + 'category with no qualifying entry is answered "none yet" with the reason, never left ' + "out: `revise` an answer that skips one. The summary names every category's pick in " + 'one compact run ("Strategy: X; Family: Y; ..."), since the findings may be cut from ' + "the DM: `revise` a summary that leaves a category to the findings alone."
+  ];
+}
+
 // node_modules/@rackbops/docket-types/dist/research.js
 function usesSentSources(config) {
   return typeof config.sources === "string" && config.sources.trim().toLowerCase() === "sent";
@@ -3187,9 +3238,13 @@ function earlierBlock(earlier) {
 function disallowed(sent) {
   return [...DEFAULT_DISALLOWED_TOOLS, ...sent ? SENT_DISALLOWED_TOOLS : WEB_DISALLOWED_TOOLS];
 }
+function allowed(webFirst) {
+  return [...webFirst ? WEB_ALLOWED_TOOLS : DEFAULT_ALLOWED_TOOLS];
+}
 function researchJob(config, pages, earlier, options = {}) {
   const canWait = options.canWait === true && pages === undefined && earlier === undefined;
   const sent = pages !== undefined;
+  const webFirst = !sent && earlier === undefined;
   const prompt = [
     "You are researching a one-off question for a person, who will read your answer as a " + "Discord DM.",
     "",
@@ -3203,8 +3258,10 @@ function researchJob(config, pages, earlier, options = {}) {
       ""
     ] : [],
     ...partsLines(earlier !== undefined),
+    ...categoryLines(earlier !== undefined),
     "",
     ...bestSourceLines(sent, canWait),
+    ...webFirst ? ["", ...firecrawlLines(), ...bggSearchHint()] : [],
     "",
     "Use web search and fetch pages to check facts. Prefer primary sources (manufacturers, " + "government, utilities, standards bodies). Every claim that a reader might act on needs a " + "source you actually opened. Say plainly where sources disagree or where you are unsure.",
     "",
@@ -3220,7 +3277,7 @@ function researchJob(config, pages, earlier, options = {}) {
   return {
     prompt,
     jsonSchema: ANSWER_SCHEMA,
-    allowedTools: [...DEFAULT_ALLOWED_TOOLS],
+    allowedTools: allowed(webFirst),
     disallowedTools: disallowed(sent),
     maxTurns: RESEARCH_MAX_TURNS,
     maxBudgetUsd: RESEARCH_MAX_BUDGET_USD,
@@ -3238,7 +3295,7 @@ function partsLines(second) {
 function bestSourceLines(pages, canWait) {
   return [
     "For each part, decide first which source is the best one for it: the site people in that " + "field treat as the reference (for board games, BoardGameGeek; for listings and sold " + "prices, eBay; otherwise the maker, the standards body or the official record). The " + "answer should rest on it.",
-    (pages ? "BoardGameGeek and eBay are not opened from this run: do not try. When the best source " + "is one of them and no gathered page is from it, or a page refused you (a 403, a " + "CAPTCHA or challenge page, an empty or blocked body, a sign-in wall)" : "Open BoardGameGeek like any other site: an ordinary read, with nothing to get round a " + "refusal. eBay is not opened from this run: do not try it. When the best source is " + "eBay, or its page refused you (BoardGameGeek or any other: a 403, a CAPTCHA or " + "challenge page, an empty or blocked body, a sign-in wall)") + (canWait ? ", list it in `blocked` with its site, its URL only when that is the page's real " + "address (such as BoardGameGeek's ranking or browse page), never a guessed one, and " + "why; then answer from the best sources you could open. Never write in `summary` or " + '`uncertain` that you "didn\'t check" it: `blocked` is where that goes, and the ' + "person's own browser can gather it for a fuller pass." : ", answer from the best sources you could open and name the missing source in one " + "short `uncertain` line, such as " + (pages ? '"BoardGameGeek was not among the pages read"' : '"BoardGameGeek refused the request, so its ranking is not used"') + ": no fuller pass follows this answer, so that line is how the person learns of it.")
+    (pages ? "BoardGameGeek and eBay are not opened from this run: do not try. When the best source " + "is one of them and no gathered page is from it, or a page refused you (a 403, a " + "CAPTCHA or challenge page, an empty or blocked body, a sign-in wall)" : "Open BoardGameGeek like any other site: an ordinary read, with nothing that disguises " + "the request; a page that refuses WebFetch gets one more try through " + "`firecrawl_scrape`, as below (0.11.0). eBay is not opened from this run: do not try it. When the best source is " + "eBay, or its page refused you (BoardGameGeek or any other: a 403, a CAPTCHA or " + "challenge page, an empty or blocked body, a sign-in wall)") + (canWait ? ", list it in `blocked` with its site, its URL only when that is the page's real " + "address (such as BoardGameGeek's ranking or browse page), never a guessed one, and " + "why; then answer from the best sources you could open. Never write in `summary` or " + '`uncertain` that you "didn\'t check" it: `blocked` is where that goes, and the ' + "person's own browser can gather it for a fuller pass." : ", answer from the best sources you could open and name the missing source in one " + "short `uncertain` line, such as " + (pages ? '"BoardGameGeek was not among the pages read"' : '"BoardGameGeek refused the request, so its ranking is not used"') + ": no fuller pass follows this answer, so that line is how the person learns of it.")
   ];
 }
 function reviewJob(config, draft, pages, earlier, options = {}) {
@@ -3262,16 +3319,16 @@ function reviewJob(config, draft, pages, earlier, options = {}) {
       "- A claim citing a gathered page's `url`: check it against that page's text above; " + "do not try to open it, and do not open BoardGameGeek or eBay at all.",
       "- A claim resting only on a BoardGameGeek or eBay address that is not one of the " + "gathered pages cannot be checked: move it to `uncertain`."
     ] : [],
-    ...earlier ? updateChecks() : answerChecks(),
-    ...earlier || sent ? [] : bestSourceChecks(canWait),
+    ...earlier ? updateChecks() : [...answerChecks(), ...categoryChecks()],
+    ...earlier || sent ? [] : [...bestSourceChecks(canWait), ...firecrawlChecks()],
     "",
-    "Then give a verdict: `approve` if the draft stands as is and covers every part (return it " + "unchanged in `answer`); `revise` if it stands once corrected (return the corrected " + "answer in `answer`); `reject` if editing cannot fix it. List each problem you found in " + "`problems`, one line each."
+    "Then give a verdict: `approve` if the draft stands as is and covers every part (leave " + "`answer` out: the draft is sent as it is); `revise` if it stands once corrected (return the corrected " + "answer in `answer`); `reject` if editing cannot fix it. List each problem you found in " + "`problems`, one line each."
   ].join(`
 `);
   return {
     prompt,
     jsonSchema: REVIEW_SCHEMA,
-    allowedTools: [...DEFAULT_ALLOWED_TOOLS],
+    allowedTools: allowed(!sent && earlier === undefined),
     disallowedTools: disallowed(sent),
     maxTurns: REVIEW_MAX_TURNS,
     maxBudgetUsd: REVIEW_MAX_BUDGET_USD,
@@ -3289,7 +3346,7 @@ function answerChecks() {
 function bestSourceChecks(canWait) {
   return [
     "- Name the best source for each part: the site its field treats as the reference (for " + "board games, BoardGameGeek; for listings and sold prices, eBay). If the answer leans on " + "secondary sources while that source is neither among its findings' sources nor " + (canWait ? "in `blocked`, the verdict is `revise`: add it to `blocked` (its site, its URL only " + "when that is the page's real address, such as BoardGameGeek's ranking or browse " + "page, never a guessed one, and why) and keep the answer from the sources it has." : "named in `uncertain`, the verdict is `revise`: add one short `uncertain` line naming " + "it, and keep the answer from the sources it has."),
-    "- You may open BoardGameGeek like any site. eBay is never opened by these runs: a claim " + "resting only on an eBay address came from a search listing, not a page anyone opened, " + "so move it to `uncertain`.",
+    "- You may open BoardGameGeek like any site. eBay is never opened by these runs, through " + "any tool (WebFetch, Firecrawl or another): a claim resting only on an eBay address, " + "whichever tool listed or fetched it, is not one an answer may rest on, so move it to " + "`uncertain`.",
     ...canWait ? [
       "- A page that refused is not read, so a claim must not say a source was checked " + `unless a finding cites it. A line saying a source was not checked ("I didn't ` + 'check BoardGameGeek") is no answer: move it to `blocked` on a `revise`.'
     ] : []
@@ -3361,7 +3418,7 @@ function afterResearch(ctx, state, output) {
   };
 }
 function afterReview(ctx, state, output, canWait) {
-  const review = parseReview(output);
+  const review = parseReview(output, state.draft ?? undefined);
   if (!review)
     return failed(ctx, state, "malformed", "no usable verdict in the structured output");
   if (state.pass === 2)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rackbops/plugin-tracker",
-  "version": "0.31.2",
+  "version": "0.31.4",
   "description": "The task tracker for Rackbops Clerk: reminders, renewals, price drops, one-off research (on the web, or on pages your own browser gathers and sends in through the task API, with a fuller pass on pages the research could not open) and an interest scout (through city-hall, with their findings), a want-list watcher (listing pages you paste, BoardGameGeek through its API once its token is set, and eBay and BoardGameGeek listings you send in through the task API or that eBay's saved-search alert emails forwarded to your alert address carry, which the watcher never opens; with the model checking each new listing and its seller first, through city-hall) by slash command, delivered by DM with buttons, and a daily DM at each person's hour of what is due today and overdue, on docket's SQLite store (/allow, /register, /remind, /renewal, /price, /research, /scout, /want, /tasks, /task, /settings, /web), with a web area for your tasks, history and settings, a web editor to make, change, pause and delete your own tasks (research requests too, made but not changed, and scouts, made and changed), an admin view (with the DMs that did not arrive, raising a person's daily model ceiling, and daily model usage per person), an operator switch that turns the daily budgets off for the alpha, forget-me, and a JSON task API with personal API tokens",
   "type": "module",
   "main": "dist/plugin.js",
@@ -11,8 +11,8 @@
     "directory": "plugins/tracker"
   },
   "devDependencies": {
-    "@rackbops/docket-core": "^0.10.0",
-    "@rackbops/docket-types": "^0.10.0",
+    "@rackbops/docket-core": "^0.11.1",
+    "@rackbops/docket-types": "^0.11.1",
     "@rackbops/styles": "^0.2.42"
   },
   "peerDependencies": {