@wonsukchoi/crondex 0.12.0 → 0.13.0

package/README.md

@@ -93,52 +93,52 @@ tags, variables) use `crondex list`, `crondex recommend`, or browse
 <!-- BEGIN JOB SUMMARY -->
 257 jobs across 44 categories:
 
-| category | jobs |
-|---|---|
-| `agriculture` | 5 |
-| `automotive` | 3 |
-| `childcare` | 3 |
-| `construction` | 5 |
-| `content` | 13 |
-| `creator` | 5 |
-| `crypto` | 5 |
-| `devops` | 26 |
-| `ecommerce` | 5 |
-| `education` | 5 |
-| `events` | 5 |
-| `finance` | 10 |
-| `fitness` | 3 |
-| `fleet` | 5 |
-| `gaming` | 5 |
-| `government` | 3 |
-| `growth` | 5 |
-| `healthcare` | 5 |
-| `hiring` | 5 |
-| `home` | 5 |
-| `hospitality` | 5 |
-| `hr` | 5 |
-| `insurance` | 5 |
-| `inventory` | 5 |
-| `investing` | 5 |
-| `learning` | 5 |
-| `legal` | 5 |
-| `logistics` | 5 |
-| `manufacturing` | 5 |
-| `marketing` | 5 |
-| `nonprofit` | 5 |
-| `personal` | 9 |
-| `podcast` | 5 |
-| `productivity` | 9 |
-| `realestate` | 5 |
-| `restaurant` | 5 |
-| `retail` | 3 |
-| `sales` | 5 |
-| `security` | 14 |
-| `support` | 5 |
-| `team` | 5 |
-| `travel` | 5 |
-| `veterinary` | 3 |
-| `warehousing` | 3 |
+| category | jobs | description |
+|---|---|---|
+| `agriculture` | 5 | Farm operations — weather risk, irrigation, equipment, market prices. |
+| `automotive` | 3 | Repair shop workflow — repair orders, parts, loaners. |
+| `childcare` | 3 | Daycare compliance and ops — ratios, immunizations, tuition. |
+| `construction` | 5 | Job site compliance — permits, inspections, change orders, rentals. |
+| `content` | 13 | Site/content health — SEO, broken links, freshness, repurposing. |
+| `creator` | 5 | Influencer/creator ops — content calendar, cross-posting, sponsorships. |
+| `crypto` | 5 | Wallets, gas prices, DeFi risk, and token unlock schedules. |
+| `devops` | 26 | Infra health — backups, deploys, dependencies, monitoring. |
+| `ecommerce` | 5 | Storefront ops — carts, stock, returns, reviews. |
+| `education` | 5 | Classroom ops — grading, attendance, deadlines, permission slips. |
+| `events` | 5 | Event planning — budget, RSVPs, staffing, vendors, day-of check-in. |
+| `finance` | 10 | Personal/business finance — budgets, invoices, taxes, subscriptions. |
+| `fitness` | 3 | Gym/studio ops — memberships, class utilization, equipment. |
+| `fleet` | 5 | Vehicle fleet compliance — maintenance, registration, licenses, fuel. |
+| `gaming` | 5 | Streaming and community server ops — schedules, patches, tournaments. |
+| `government` | 3 | Public-sector ops — records requests, permits, constituent casework. |
+| `growth` | 5 | Lifecycle marketing — churn, trials, onboarding, reviews. |
+| `healthcare` | 5 | Clinic ops — appointments, recalls, licenses, lab results. |
+| `hiring` | 5 | Recruiting pipeline — candidates, offers, interviews, reqs. |
+| `home` | 5 | Household reminders — maintenance, warranties, plants, safety. |
+| `hospitality` | 5 | Hotel ops — guest reviews, inspections, maintenance requests. |
+| `hr` | 5 | People ops — payroll, onboarding, benefits, reviews, offboarding. |
+| `insurance` | 5 | Policy tracking — renewals, claims, coverage, certificates. |
+| `inventory` | 5 | Stock accuracy — counts, shrinkage, expiry, overstock. |
+| `investing` | 5 | Portfolio tracking — prices, dividends, rebalancing, taxes. |
+| `learning` | 5 | Personal learning — certs, courses, flashcards, reading. |
+| `legal` | 5 | Contracts and deadlines — NDAs, trademarks, court, compliance filings. |
+| `logistics` | 5 | Shipping ops — customs, freight, delays, fees. |
+| `manufacturing` | 5 | Production ops — downtime, defects, maintenance, suppliers, materials. |
+| `marketing` | 5 | Campaign ops — ad spend, SEO rank, deliverability, competitors. |
+| `nonprofit` | 5 | Fundraising ops — grants, donors, volunteers, board follow-ups. |
+| `personal` | 9 | Daily life reminders — bills, habits, meals, screen time. |
+| `podcast` | 5 | Show ops — publish cadence, guests, sponsors, ratings. |
+| `productivity` | 9 | Work habits — inbox, standups, focus, meetings, reports. |
+| `realestate` | 5 | Property management — leases, rent, vacancy, inspections, tax. |
+| `restaurant` | 5 | Kitchen/FOH ops — food cost, labor cost, waste, inspections. |
+| `retail` | 3 | Store ops — till reconciliation, opening checklist, scheduling. |
+| `sales` | 5 | Pipeline ops — leads, deals, quota, CRM sync. |
+| `security` | 14 | Security posture — keys, certs, access, scans, firewalls. |
+| `support` | 5 | Helpdesk ops — SLA, backlog, CSAT, agent workload. |
+| `team` | 5 | Team ops — 1:1s, on-call, PTO, anniversaries. |
+| `travel` | 5 | Trip logistics — flights, passports, visas, insurance, miles. |
+| `veterinary` | 3 | Clinic ops for animals — vaccines, controlled substances, boarding. |
+| `warehousing` | 3 | Warehouse ops — dock scheduling, pick/pack errors, climate control. |
 <!-- END JOB SUMMARY -->
 
 ---

package/bin/crondex.js

@@ -4,6 +4,7 @@ import { readFileSync, writeFileSync, existsSync } from "node:fs";
 import { join } from "node:path";
 import yaml from "js-yaml";
 import { tokenize, rankJobs } from "../lib/recommend.js";
+import { CATEGORY_DESCRIPTIONS } from "../lib/category-descriptions.js";
 
 const ROOT = new URL("..", import.meta.url).pathname;
 const CATALOG = JSON.parse(readFileSync(join(ROOT, "catalog.json"), "utf8"));
@@ -134,11 +135,16 @@ function categories() {
   const counts = {};
   for (const j of CATALOG.jobs) counts[j.category] = (counts[j.category] ?? 0) + 1;
   const sorted = Object.entries(counts).sort(([a], [b]) => a.localeCompare(b));
-  if (hasFlag("json")) return printJson(sorted.map(([category, count]) => ({ category, count })));
+  if (hasFlag("json")) {
+    return printJson(
+      sorted.map(([category, count]) => ({ category, count, description: CATEGORY_DESCRIPTIONS[category] ?? "" }))
+    );
+  }
   console.log(catalogInfoLine());
   console.log();
   for (const [cat, n] of sorted) {
     console.log(`${cat}  (${n})`);
+    if (CATEGORY_DESCRIPTIONS[cat]) console.log(`  ${CATEGORY_DESCRIPTIONS[cat]}`);
   }
 }
 

package/lib/catalog-summary.js

@@ -0,0 +1,47 @@
+// Catalog-building logic behind scripts/build-catalog.js — pulled out so it's unit
+// testable directly (see test/catalog-summary.test.js).
+
+export const MODES_BY_RUNNER = {
+  "agent-prompt": ["agent-prompt"],
+  shell: ["script"],
+  hybrid: ["script", "agent-prompt"],
+};
+
+export function modesForRunner(runner) {
+  return MODES_BY_RUNNER[runner] ?? [];
+}
+
+export function countByCategory(jobs) {
+  const counts = new Map();
+  for (const j of jobs) counts.set(j.category, (counts.get(j.category) ?? 0) + 1);
+  return counts;
+}
+
+export function findMissingDescriptions(categories, categoryDescriptions) {
+  return categories.filter((c) => !categoryDescriptions[c]);
+}
+
+// Builds the markdown lines that go between the BEGIN/END JOB SUMMARY markers.
+export function buildSummaryLines(jobs, categoryDescriptions) {
+  const byCategory = countByCategory(jobs);
+  const categories = [...byCategory.keys()].sort();
+  return [
+    `${jobs.length} jobs across ${categories.length} categories:`,
+    "",
+    "| category | jobs | description |",
+    "|---|---|---|",
+    ...categories.map((c) => `| \`${c}\` | ${byCategory.get(c)} | ${categoryDescriptions[c] ?? ""} |`),
+  ];
+}
+
+const BEGIN = "<!-- BEGIN JOB SUMMARY -->";
+const END = "<!-- END JOB SUMMARY -->";
+
+// Splices summaryLines between the BEGIN/END markers in readmeText. Returns null if
+// the markers aren't found (caller decides how to warn/handle that).
+export function spliceReadmeSummary(readmeText, summaryLines) {
+  const start = readmeText.indexOf(BEGIN);
+  const end = readmeText.indexOf(END);
+  if (start === -1 || end === -1) return null;
+  return readmeText.slice(0, start + BEGIN.length) + "\n" + summaryLines.join("\n") + "\n" + readmeText.slice(end);
+}

package/lib/category-descriptions.js

@@ -0,0 +1,50 @@
+// One-line description per job category, for the README table and `crondex categories`.
+// Keep entries short — this is a browsing aid, not a spec. Add a new entry whenever a
+// job introduces a category that isn't listed here (a missing entry is a soft warning
+// from scripts/build-catalog.js, not a hard failure).
+export const CATEGORY_DESCRIPTIONS = {
+  agriculture: "Farm operations — weather risk, irrigation, equipment, market prices.",
+  automotive: "Repair shop workflow — repair orders, parts, loaners.",
+  childcare: "Daycare compliance and ops — ratios, immunizations, tuition.",
+  construction: "Job site compliance — permits, inspections, change orders, rentals.",
+  content: "Site/content health — SEO, broken links, freshness, repurposing.",
+  creator: "Influencer/creator ops — content calendar, cross-posting, sponsorships.",
+  crypto: "Wallets, gas prices, DeFi risk, and token unlock schedules.",
+  devops: "Infra health — backups, deploys, dependencies, monitoring.",
+  ecommerce: "Storefront ops — carts, stock, returns, reviews.",
+  education: "Classroom ops — grading, attendance, deadlines, permission slips.",
+  events: "Event planning — budget, RSVPs, staffing, vendors, day-of check-in.",
+  finance: "Personal/business finance — budgets, invoices, taxes, subscriptions.",
+  fitness: "Gym/studio ops — memberships, class utilization, equipment.",
+  fleet: "Vehicle fleet compliance — maintenance, registration, licenses, fuel.",
+  gaming: "Streaming and community server ops — schedules, patches, tournaments.",
+  government: "Public-sector ops — records requests, permits, constituent casework.",
+  growth: "Lifecycle marketing — churn, trials, onboarding, reviews.",
+  healthcare: "Clinic ops — appointments, recalls, licenses, lab results.",
+  hiring: "Recruiting pipeline — candidates, offers, interviews, reqs.",
+  home: "Household reminders — maintenance, warranties, plants, safety.",
+  hospitality: "Hotel ops — guest reviews, inspections, maintenance requests.",
+  hr: "People ops — payroll, onboarding, benefits, reviews, offboarding.",
+  insurance: "Policy tracking — renewals, claims, coverage, certificates.",
+  inventory: "Stock accuracy — counts, shrinkage, expiry, overstock.",
+  investing: "Portfolio tracking — prices, dividends, rebalancing, taxes.",
+  learning: "Personal learning — certs, courses, flashcards, reading.",
+  legal: "Contracts and deadlines — NDAs, trademarks, court, compliance filings.",
+  logistics: "Shipping ops — customs, freight, delays, fees.",
+  manufacturing: "Production ops — downtime, defects, maintenance, suppliers, materials.",
+  marketing: "Campaign ops — ad spend, SEO rank, deliverability, competitors.",
+  nonprofit: "Fundraising ops — grants, donors, volunteers, board follow-ups.",
+  personal: "Daily life reminders — bills, habits, meals, screen time.",
+  podcast: "Show ops — publish cadence, guests, sponsors, ratings.",
+  productivity: "Work habits — inbox, standups, focus, meetings, reports.",
+  realestate: "Property management — leases, rent, vacancy, inspections, tax.",
+  restaurant: "Kitchen/FOH ops — food cost, labor cost, waste, inspections.",
+  retail: "Store ops — till reconciliation, opening checklist, scheduling.",
+  sales: "Pipeline ops — leads, deals, quota, CRM sync.",
+  security: "Security posture — keys, certs, access, scans, firewalls.",
+  support: "Helpdesk ops — SLA, backlog, CSAT, agent workload.",
+  team: "Team ops — 1:1s, on-call, PTO, anniversaries.",
+  travel: "Trip logistics — flights, passports, visas, insurance, miles.",
+  veterinary: "Clinic ops for animals — vaccines, controlled substances, boarding.",
+  warehousing: "Warehouse ops — dock scheduling, pick/pack errors, climate control.",
+};

package/lib/duplicates.js

@@ -0,0 +1,29 @@
+// Near-duplicate detection logic behind scripts/check-duplicates.js — pulled out so
+// it's unit testable directly (see test/duplicates.test.js).
+
+export function jaccard(a, b) {
+  if (a.size === 0 && b.size === 0) return 0;
+  let intersection = 0;
+  for (const x of a) if (b.has(x)) intersection++;
+  const union = a.size + b.size - intersection;
+  return union === 0 ? 0 : intersection / union;
+}
+
+// jobs: array of { id, tags: Set<string>, description: Set<string>, ...rest }.
+// A pair is flagged only when BOTH tag and description overlap clear their
+// threshold — tag overlap alone false-positives on jobs that just share a couple
+// of generic tags, and description overlap alone false-positives on jobs
+// following the same wording template for genuinely different systems.
+export function findDuplicates(jobs, { tagThreshold = 0.6, descThreshold = 0.5 } = {}) {
+  const flagged = [];
+  for (let i = 0; i < jobs.length; i++) {
+    for (let j = i + 1; j < jobs.length; j++) {
+      const a = jobs[i];
+      const b = jobs[j];
+      const tagSim = jaccard(a.tags, b.tags);
+      const descSim = jaccard(a.description, b.description);
+      if (tagSim >= tagThreshold && descSim >= descThreshold) flagged.push({ a, b, tagSim, descSim });
+    }
+  }
+  return flagged.sort((x, y) => y.tagSim + y.descSim - (x.tagSim + x.descSim));
+}

package/lib/shellcheck-prep.js

@@ -0,0 +1,20 @@
+// Turns a crondex `command` field (with {{placeholder}} templating) into a script
+// shellcheck can actually parse — pulled out of scripts/lint-shell.js so the
+// substitution itself is unit testable (see test/shellcheck-prep.test.js).
+//
+// crondex substitutes {{placeholders}} as literal text before bash ever sees the
+// script, so each placeholder is stood in as a real (braced) bash variable — braced
+// so a literal suffix right after it (e.g. "{{days}}d") doesn't get glued into the
+// variable name — just to let shellcheck catch actual quoting/syntax bugs.
+const PLACEHOLDER_RE = /\{\{\s*(\w+)\s*\}\}/g;
+
+export function extractPlaceholders(command) {
+  return [...new Set([...command.matchAll(PLACEHOLDER_RE)].map((m) => m[1]))];
+}
+
+export function buildShellcheckScript(command) {
+  const placeholders = extractPlaceholders(command);
+  const header = placeholders.map((name) => `${name}="42"`).join("\n");
+  const body = command.replace(PLACEHOLDER_RE, "$${$1}");
+  return `#!/usr/bin/env bash\n${header}\n${body}`;
+}

package/package.json

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