@wonsukchoi/crondex 0.17.0 → 0.19.0

package/jobs/veterinary/medication-inventory-expiry-check.yaml

@@ -0,0 +1,31 @@
+id: medication-inventory-expiry-check
+version: 1
+name: Medication Inventory Expiry Check
+description: >
+  Scans the clinic's drug and vaccine inventory log for items expiring
+  soon so they can be used, returned, or discarded before they go bad.
+  Use this if expired medication has ever turned up still on the shelf
+  during an audit.
+category: veterinary
+tags: [veterinary, inventory, medication, expiry]
+schedule: "0 8 * * 1"
+timezone: "UTC"
+runner: shell
+command: >
+  today_epoch=$(date +%s); warn_days={{warn_days_before_expiry}};
+  { read -r header; while IFS=',' read -r drug lot expiry; do
+      [ -z "$drug" ] && continue;
+      exp_epoch=$(date -j -f %Y-%m-%d "$expiry" +%s 2>/dev/null || date -d "$expiry" +%s);
+      days_left=$(( (exp_epoch-today_epoch)/86400 ));
+      if [ "$days_left" -lt 0 ]; then echo "EXPIRED: $drug (lot $lot) expired on $expiry — remove from shelf.";
+      elif [ "$days_left" -le "$warn_days" ]; then echo "EXPIRING SOON: $drug (lot $lot), $days_left day(s) left ($expiry)."; fi
+    done; } < "{{inventory_csv_path}}"
+variables:
+  inventory_csv_path:
+    default: "./medication-inventory.csv"
+    description: "Path to a CSV with columns: drug_name,lot_number,expiry_date (YYYY-MM-DD)."
+  warn_days_before_expiry:
+    default: 30
+    description: Flag items expiring within this many days.
+compatible_agents: [generic, claude, codex]
+notes: Zero-token. Read-only check — always visually confirm an item before discarding or returning it.

package/jobs/warehousing/returns-processing-backlog-check.yaml

@@ -0,0 +1,33 @@
+id: returns-processing-backlog-check
+version: 1
+name: Returns Processing Backlog Check
+description: >
+  Scans the returns log for items that have sat unprocessed longer than
+  your target turnaround time. Use this if returned inventory has ever
+  piled up because nobody was tracking how long items had been waiting
+  to be inspected and restocked or disposed of.
+category: warehousing
+tags: [warehousing, returns, backlog, logistics]
+schedule: "0 7 * * *"
+timezone: "UTC"
+runner: shell
+command: >
+  today_epoch=$(date +%s); max_days={{max_days_in_queue}};
+  { read -r header; while IFS=',' read -r rma_id received_date status; do
+      [ -z "$rma_id" ] && continue;
+      [ "$status" = "processed" ] && continue;
+      recv_epoch=$(date -j -f %Y-%m-%d "$received_date" +%s 2>/dev/null || date -d "$received_date" +%s);
+      days_waiting=$(( (today_epoch-recv_epoch)/86400 ));
+      if [ "$days_waiting" -ge "$max_days" ]; then
+        echo "BACKLOGGED: RMA $rma_id received $received_date, $days_waiting day(s) unprocessed (status: $status).";
+      fi
+    done; } < "{{returns_log_csv_path}}"
+variables:
+  returns_log_csv_path:
+    default: "./returns-log.csv"
+    description: "Path to a CSV with columns: rma_id,received_date (YYYY-MM-DD),status (processed/pending/etc)."
+  max_days_in_queue:
+    default: 3
+    description: Flag returns that have sat unprocessed this many days or longer.
+compatible_agents: [generic, claude, codex]
+notes: Zero-token. Assumes one row per return in the CSV; any status other than "processed" is treated as still in queue.

package/lib/recommend.js

@@ -16,13 +16,81 @@ export function stem(word) {
   return word;
 }
 
+// Groups of interchangeable words, grounded in the catalog's actual vocabulary (its
+// most common tags/description verbs) rather than a generic thesaurus — this closes
+// the gap where a query uses a reasonable synonym the job authors didn't happen to
+// write (e.g. "notify" vs. a job tagged "reminder"). Every word in a group maps to
+// the group's first entry, applied on both the query and the job's own fields so
+// either side using a different synonym still lines up.
+const SYNONYM_GROUPS = [
+  ["alert", "warn", "notify", "notification", "remind", "reminder"],
+  ["check", "monitor", "watch", "scan", "inspect", "verify"],
+  ["audit", "review", "compliance"],
+  ["expire", "expiry", "expiration"],
+  ["backup", "snapshot"],
+  ["cost", "spend", "spending", "budget", "expense", "billing"],
+  ["fail", "failure", "error", "crash", "outage"],
+  ["delete", "remove", "cleanup", "purge", "clear"],
+  ["update", "upgrade", "refresh", "sync"],
+  ["duplicate", "dedupe", "dup"],
+  ["deadline", "due"],
+  ["schedule", "scheduling", "calendar", "planning"],
+  ["drift", "diff", "change", "changed"],
+  ["renew", "renewal"],
+  ["followup", "follow-up"],
+  ["invoice", "billing", "payment"],
+  ["stale", "outdated", "old"],
+];
+
+const SYNONYM_MAP = new Map();
+for (const group of SYNONYM_GROUPS) {
+  for (const word of group) SYNONYM_MAP.set(word, group[0]);
+}
+
+export function canonicalize(word) {
+  return SYNONYM_MAP.get(word) ?? word;
+}
+
 export function tokenize(text) {
   return text
     .toLowerCase()
     .replace(/[^a-z0-9\s-]/g, " ")
     .split(/[\s-]+/)
     .filter((w) => w.length > 1 && !STOPWORDS.has(w))
-    .map(stem);
+    .map(stem)
+    .map(canonicalize);
+}
+
+// Bounded edit distance — used only as a fallback when no exact token match exists,
+// to catch typos/near-misses (e.g. "expiery" vs "expiry") without embeddings or a
+// spellcheck dependency. Short-circuits past `max` so it stays cheap across a whole
+// catalog scan.
+export function editDistance(a, b, max = 2) {
+  if (Math.abs(a.length - b.length) > max) return max + 1;
+  const prev = new Array(b.length + 1);
+  const curr = new Array(b.length + 1);
+  for (let j = 0; j <= b.length; j++) prev[j] = j;
+  for (let i = 1; i <= a.length; i++) {
+    curr[0] = i;
+    let rowMin = curr[0];
+    for (let j = 1; j <= b.length; j++) {
+      curr[j] = a[i - 1] === b[j - 1] ? prev[j - 1] : 1 + Math.min(prev[j - 1], prev[j], curr[j - 1]);
+      rowMin = Math.min(rowMin, curr[j]);
+    }
+    if (rowMin > max) return max + 1;
+    for (let j = 0; j <= b.length; j++) prev[j] = curr[j];
+  }
+  return prev[b.length];
+}
+
+// A query token counts as a fuzzy hit against a field token if they're a short edit
+// distance apart — only tried once no exact match exists (see scoreJob), and only for
+// words long enough that a 1-2 character slip is plausibly a typo rather than a
+// genuinely different short word ("ssl" vs "sql" would otherwise false-positive).
+function isFuzzyMatch(queryToken, fieldToken) {
+  if (queryToken.length < 5 || fieldToken.length < 5) return false;
+  const maxDistance = queryToken.length >= 8 ? 2 : 1;
+  return editDistance(queryToken, fieldToken, maxDistance) <= maxDistance;
 }
 
 // id and name are near-duplicates of each other (id is just the slugified
@@ -33,7 +101,7 @@ export const RECOMMEND_WEIGHTS = { tags: 4, title: 3, category: 2, description:
 
 export function scoreJob(queryTokens, job) {
   const fields = {
-    tags: job.tags.map((t) => stem(t.toLowerCase())),
+    tags: job.tags.map((t) => canonicalize(stem(t.toLowerCase()))),
     title: [...new Set([...tokenize(job.name), ...tokenize(job.id.replace(/-/g, " "))])],
     category: tokenize(job.category ?? ""),
     description: tokenize(job.description ?? ""),
@@ -45,6 +113,11 @@ export function scoreJob(queryTokens, job) {
       if (fields[field].includes(qt)) {
         score += weight;
         matched.add(qt);
+      } else if (fields[field].some((ft) => isFuzzyMatch(qt, ft))) {
+        // Fuzzy hits count for half weight (rounded up) — a real match still
+        // outranks a typo-distance one for the same field.
+        score += Math.ceil(weight / 2);
+        matched.add(qt);
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wonsukchoi/crondex",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "A public directory of pre-made, agent-editable cron jobs.",
   "type": "module",
   "license": "MIT",