@wonsukchoi/crondex 0.9.1 → 0.11.0

package/README.md

@@ -1,97 +1,104 @@
-# crondex
+<div align="center">
 
-A public, growing directory of pre-made cron jobs — built so any AI agent
-(Claude, Codex, Hermes, OpenClaw, or a plain LLM with shell access) can pull
-one, tweak it, and schedule it. Clone it, grab a job, adjust the knobs, run it.
+```
+  ______________  ____  ____/ /__  _  __
+ / ___/ ___/ __ \/ __ \/ __  / _ \| |/_/
+/ /__/ /  / /_/ / / / / /_/ /  __/>  <
+\___/_/   \____/_/ /_/\__,_/\___/_/|_|
+```
 
-## Quick start
+**Pre-made cron jobs any AI agent can pull, tweak, and schedule.**
+A directory, not a framework.
 
-```bash
-git clone https://github.com/wonsukchoi/crondex.git
-cat crondex/catalog.json          # browse what's available
-cat crondex/jobs/devops/dependency-audit.yaml   # read one job
-```
+[![npm version](https://img.shields.io/npm/v/@wonsukchoi/crondex.svg)](https://www.npmjs.com/package/@wonsukchoi/crondex)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-Give an agent the repo and a goal ("set up something that checks my repo
-health every morning") — it reads `catalog.json`, finds the closest match,
-adjusts `schedule`/`variables`, and wires it into whatever scheduler it has.
+</div>
 
-## CLI
+---
 
-Published on npm as `@wonsukchoi/crondex` (the plain name `crondex` was
-blocked by npm's anti-typosquat check). The command itself is still
-`crondex` once installed — only the package name is scoped:
+Works with Claude, Codex, Hermes, OpenClaw, or any plain LLM with shell
+access.
+
+## Get a job
 
 ```bash
-npx @wonsukchoi/crondex list                          # browse everything
-npx @wonsukchoi/crondex list --category devops        # filter by category or --tag
-npx @wonsukchoi/crondex categories                    # list categories with job counts
-npx @wonsukchoi/crondex show backup-reminder          # print one job's YAML
-npx @wonsukchoi/crondex add backup-reminder --dest ./cron/backup-reminder.yaml
 npx @wonsukchoi/crondex recommend "warn me before my SSL cert expires"
-npx @wonsukchoi/crondex init ssl-cert-expiry-check --category security
+npx @wonsukchoi/crondex show ssl-cert-expiry-check
+npx @wonsukchoi/crondex add ssl-cert-expiry-check --dest ./cron/ssl-cert-expiry-check.yaml
 ```
 
-`recommend` takes a free-text description of what you want and ranks the
-catalog against it (weighted keyword match over tags/name/id/category/
-description, zero tokens, no network call) — handy for an agent that just
-got asked "can you set up something for X" and needs to check whether a
-ready-made job already covers it before writing one from scratch. Add
-`--limit <n>` to control how many results come back (default 5).
+- `recommend "<what you want>"` — find the closest matching job (zero
+  tokens, no network call, so an agent can check before writing one from
+  scratch)
+- `list [--category x] [--tag y]` / `categories` — browse everything
+- `show <id>` — print a job's full YAML
+- `add <id> [--dest path]` — copy it into your project to edit
+- `init <id> [--category x]` — scaffold a brand-new job from the template
 
-`init` scaffolds a new job file from `templates/job.template.yaml` into your
-own project (default `./<id>.yaml`) — for writing a job that isn't in the
-catalog yet, whether or not you plan to contribute it back.
+Add `--json` to `list`/`categories`/`show`/`recommend` for machine-readable
+output — useful when an agent is parsing the result programmatically
+instead of a human reading it.
 
-Or install once and drop the scope prefix on every call:
+No install needed — `npx` always runs against the latest catalog. Prefer
+installing once? `npm install -g @wonsukchoi/crondex`, then drop the `npx`
+prefix (run `npm update -g` later to pick up new jobs). Prefer no npm at
+all? `git clone` this repo and run `node bin/crondex.js list`.
 
-```bash
-npm install -g @wonsukchoi/crondex
-crondex list
-```
+---
 
-`add` copies the job's YAML as-is into your project — it's yours to edit
-from there. `npx` always pulls the latest published catalog; a global
-install needs `npm update -g @wonsukchoi/crondex` to see new jobs (`crondex
-list` prints a reminder either way).
+## What's in a job
 
-A clone works too, no npm required:
+Every job is one YAML file:
 
-```bash
-git clone https://github.com/wonsukchoi/crondex.git && cd crondex
-node bin/crondex.js list
+```yaml
+id: dependency-audit
+version: 1
+name: Dependency Vulnerability Audit
+category: devops
+schedule: "0 8 * * 1"    # standard 5-field cron
+runner: hybrid            # shell | agent-prompt | hybrid
+command: |                 # for runner: shell/hybrid
+  ...raw shell audit, zero tokens...
+prompt: |                  # for runner: agent-prompt/hybrid
+  ...instructions with {{repo_path}}, LLM synthesizes+prioritizes...
+script_note: what you lose by using `command` instead of `prompt`
+variables:
+  repo_path:
+    default: "."
+compatible_agents: [claude, codex, hermes, openclaw, generic]
 ```
 
-## Layout
+- **`shell`** — runs `command` only. Zero LLM tokens, deterministic.
+- **`agent-prompt`** — hands `prompt` to an LLM each run. Costs tokens, but
+  can synthesize, prioritize, and draft prose.
+- **`hybrid`** — ships both, pick per run: script to save tokens, prompt for
+  more judgment. `script_note` explains the tradeoff.
 
-```
-crondex/
-├── bin/crondex.js         CLI: list / categories / show / add / recommend / init
-├── catalog.json           generated index of every job — read this first
-├── schema/job.schema.json spec every job file follows
-├── jobs/                  one YAML per job, grouped by category subdirectory
-└── scripts/
-    ├── build-catalog.js   regenerates catalog.json + the summary below from jobs/**/*.yaml
-    └── validate-jobs.js   validates every job against the schema
-```
+`{{placeholders}}` resolve from `variables` — override them for your case,
+then hand `command`/`prompt` plus `schedule` to whatever scheduler you have
+(system crontab, a hosted cron, your agent's own scheduling mechanism). This
+repo defines *what* to run and *when*, not the executor. Full field spec:
+[`schema/job.schema.json`](schema/job.schema.json).
+
+---
 
-## Available jobs
+## Browse the catalog
 
-Full details (description, tags, variables) live in `catalog.json` and each
-job's YAML file — run `crondex list`, `crondex recommend "<what you want>"`,
-or browse `jobs/<category>/` for the plain-language rundown of each. The
-counts below are regenerated by `npm run build-catalog`, so they never drift
-from what's actually in `jobs/`.
+The table below is regenerated by `npm run build-catalog`, so it never
+drifts from what's actually in `jobs/`. For full details (description,
+tags, variables) use `crondex list`, `crondex recommend`, or browse
+`jobs/<category>/` directly.
 
 <!-- BEGIN JOB SUMMARY -->
-182 jobs across 37 categories:
+189 jobs across 37 categories:
 
 | category | jobs |
 |---|---|
 | `agriculture` | 3 |
 | `construction` | 3 |
-| `content` | 12 |
-| `creator` | 3 |
+| `content` | 13 |
+| `creator` | 4 |
 | `crypto` | 3 |
 | `devops` | 26 |
 | `ecommerce` | 3 |
@@ -100,7 +107,7 @@ from what's actually in `jobs/`.
 | `finance` | 10 |
 | `fleet` | 3 |
 | `gaming` | 3 |
-| `growth` | 4 |
+| `growth` | 5 |
 | `healthcare` | 3 |
 | `hiring` | 3 |
 | `home` | 5 |
@@ -110,80 +117,47 @@ from what's actually in `jobs/`.
 | `inventory` | 3 |
 | `investing` | 3 |
 | `learning` | 5 |
-| `legal` | 3 |
+| `legal` | 4 |
 | `logistics` | 3 |
 | `manufacturing` | 3 |
 | `marketing` | 4 |
 | `nonprofit` | 3 |
-| `personal` | 8 |
+| `personal` | 9 |
 | `podcast` | 3 |
 | `productivity` | 9 |
-| `realestate` | 3 |
+| `realestate` | 4 |
 | `restaurant` | 3 |
-| `sales` | 4 |
+| `sales` | 5 |
 | `security` | 14 |
 | `support` | 3 |
 | `team` | 4 |
 | `travel` | 5 |
 <!-- END JOB SUMMARY -->
 
-## How a job works
-
-Every job is one YAML file with a `runner`:
-
-- **`shell`** — run `command` directly. Zero LLM tokens, deterministic, no
-  judgment calls.
-- **`agent-prompt`** — hand the `prompt` field to an LLM agent each run.
-  Costs tokens, but can synthesize, prioritize, and draft prose.
-- **`hybrid`** — ships both. You (or your agent) pick per run: `command` to
-  save tokens and get raw data, or `prompt` when you want the LLM to
-  interpret it. `script_note` on the job explains exactly what you trade
-  away by choosing the script.
+---
 
-`{{placeholders}}` in `command`/`prompt` resolve from `variables`. Each job
-also carries a `version` — bumped whenever `prompt`/`command` behavior
-changes, so if you've already scheduled a job elsewhere you can tell when
-the upstream copy has moved on without you.
+## Layout
 
-```yaml
-id: dependency-audit
-version: 1
-name: Dependency Vulnerability Audit
-description: ...
-category: devops
-tags: [security, dependencies]
-schedule: "0 8 * * 1"        # standard 5-field cron
-timezone: "UTC"
-runner: hybrid
-command: |
-  ...raw shell audit, zero tokens...
-prompt: |
-  ...instructions with {{repo_path}}, LLM synthesizes+prioritizes...
-script_note: what you lose by using `command` instead of `prompt`
-variables:
-  repo_path:
-    default: "."
-    description: ...
-compatible_agents: [claude, codex, hermes, openclaw, generic]
+```
+crondex/
+├── llms.txt               agent-discovery manifest (llms.txt convention)
+├── bin/crondex.js         CLI: list / categories / show / add / recommend / init
+├── lib/recommend.js       recommend's scoring logic (unit tested in test/)
+├── catalog.json           generated index of every job — read this first
+├── schema/job.schema.json spec every job file follows
+├── jobs/                  one YAML per job, grouped by category subdirectory
+└── scripts/               build-catalog.js, validate-jobs.js, lint-shell.js
 ```
 
-Full spec: [`schema/job.schema.json`](schema/job.schema.json).
-
-## Using a job
-
-1. Pick a job from `catalog.json` — check `modes` to see if it's script-only,
-   agent-prompt-only, or both.
-2. Decide script vs. agent-prompt if the job is `hybrid`: script saves
-   tokens, agent-prompt gives you more detail/judgment (see `script_note`).
-3. Override any `variables` and `schedule` for your case.
-4. Hand `command` or `prompt` plus `schedule` to your scheduler — system
-   crontab, a hosted cron, or your agent's own scheduling mechanism. This
-   repo defines *what* to run and *when*, not the executor.
+---
 
 ## Contributing a job
 
-See [`CONTRIBUTING.md`](CONTRIBUTING.md) — copy `templates/job.template.yaml`,
-fill it in, `npm run validate && npm run build-catalog`, open a PR.
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) — copy `templates/job.template.yaml`
+(or run `crondex init`), fill it in, `npm run validate && npm run
+build-catalog`, open a PR.
+
+---
 
 ## License
 

package/bin/crondex.js

@@ -2,6 +2,8 @@
 // CLI over catalog.json — browse jobs, read one, or pull one into your project.
 import { readFileSync, writeFileSync, existsSync } from "node:fs";
 import { join } from "node:path";
+import yaml from "js-yaml";
+import { tokenize, rankJobs } from "../lib/recommend.js";
 
 const ROOT = new URL("..", import.meta.url).pathname;
 const CATALOG = JSON.parse(readFileSync(join(ROOT, "catalog.json"), "utf8"));
@@ -14,6 +16,14 @@ function flag(name) {
   return i === -1 ? undefined : args[i + 1];
 }
 
+function hasFlag(name) {
+  return args.includes(`--${name}`);
+}
+
+function printJson(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
+
 function findJob(id) {
   const meta = CATALOG.jobs.find((j) => j.id === id);
   if (!meta) {
@@ -27,11 +37,11 @@ function printHelp() {
   console.log(`crondex — browse and pull pre-made cron jobs
 
 Usage:
-  crondex list [--category <name>] [--tag <name>]
-  crondex categories
-  crondex show <id>
+  crondex list [--category <name>] [--tag <name>] [--json]
+  crondex categories [--json]
+  crondex show <id> [--json]
   crondex add <id> [--dest <path>]
-  crondex recommend "<what you want done>" [--limit <n>]
+  crondex recommend "<what you want done>" [--limit <n>] [--json]
   crondex init <id> [--category <name>] [--dest <path>]
 
 Examples:
@@ -41,75 +51,39 @@ Examples:
   crondex add backup-reminder --dest ./cron/backup-reminder.yaml
   crondex recommend "warn me before my SSL cert expires"
   crondex init ssl-cert-expiry-check --category security
-`);
-}
-
-const STOPWORDS = new Set([
-  "a", "an", "the", "to", "for", "of", "in", "on", "at", "by", "and", "or", "my", "me", "i",
-  "can", "you", "do", "does", "this", "that", "these", "those", "please", "want", "wants",
-  "wanted", "need", "needs", "help", "with", "is", "are", "be", "it", "so", "when", "should",
-  "could", "would", "how", "what", "which", "up", "down", "get", "make", "set", "just", "really",
-  "some", "something", "any", "want", "us", "our", "your", "yours", "if", "then", "than",
-]);
-
-function stem(word) {
-  if (word.length > 4 && word.endsWith("ies")) return word.slice(0, -3) + "y";
-  if (word.length > 4 && word.endsWith("es") && !word.endsWith("ses")) return word.slice(0, -2);
-  if (word.length > 3 && word.endsWith("s") && !word.endsWith("ss")) return word.slice(0, -1);
-  return word;
-}
-
-function tokenize(text) {
-  return text
-    .toLowerCase()
-    .replace(/[^a-z0-9\s-]/g, " ")
-    .split(/[\s-]+/)
-    .filter((w) => w.length > 1 && !STOPWORDS.has(w))
-    .map(stem);
-}
 
-// id and name are near-duplicates of each other (id is just the slugified
-// name), so they're merged into one "title" field — otherwise a match on a
-// shared word like "water" gets weighted 3+3 instead of 3, which can outrank
-// a more specific job that only matches once via tags.
-const RECOMMEND_WEIGHTS = { tags: 4, title: 3, category: 2, description: 1 };
-
-function scoreJob(queryTokens, job) {
-  const fields = {
-    tags: job.tags.map((t) => stem(t.toLowerCase())),
-    title: [...new Set([...tokenize(job.name), ...tokenize(job.id.replace(/-/g, " "))])],
-    category: tokenize(job.category ?? ""),
-    description: tokenize(job.description ?? ""),
-  };
-  let score = 0;
-  const matched = new Set();
-  for (const qt of queryTokens) {
-    for (const [field, weight] of Object.entries(RECOMMEND_WEIGHTS)) {
-      if (fields[field].includes(qt)) {
-        score += weight;
-        matched.add(qt);
-      }
-    }
-  }
-  return { score, matchedTerms: [...matched] };
+Add --json to list/categories/show/recommend for machine-readable output —
+useful when an agent is parsing crondex's output programmatically instead
+of a human reading it.
+`);
 }
 
 function recommend(queryText) {
   const limit = Number(flag("limit")) || 5;
-  const queryTokens = tokenize(queryText);
-  if (!queryTokens.length) {
+  const json = hasFlag("json");
+  if (!tokenize(queryText).length) {
+    if (json) return printJson([]);
     console.log("query too vague to match on — describe what you want the job to check or remind you about.");
     return;
   }
-  const ranked = CATALOG.jobs
-    .map((job) => ({ job, ...scoreJob(queryTokens, job) }))
-    .filter((r) => r.score > 0)
-    .sort((a, b) => b.score - a.score)
-    .slice(0, limit);
+  const ranked = rankJobs(CATALOG.jobs, queryText, limit);
   if (!ranked.length) {
+    if (json) return printJson([]);
     console.log(`no confident match for "${queryText}". Run "crondex list" to browse everything.`);
     return;
   }
+  if (json) {
+    return printJson(
+      ranked.map((r) => ({
+        id: r.job.id,
+        category: r.job.category,
+        score: r.score,
+        matched_terms: r.matchedTerms,
+        modes: r.job.modes,
+        description: r.job.description,
+      }))
+    );
+  }
   console.log(`top match${ranked.length > 1 ? "es" : ""} for "${queryText}":`);
   console.log();
   for (const r of ranked) {
@@ -131,9 +105,11 @@ function catalogInfoLine() {
 function list() {
   const category = flag("category");
   const tag = flag("tag");
+  const json = hasFlag("json");
   const jobs = CATALOG.jobs.filter(
     (j) => (!category || j.category === category) && (!tag || j.tags.includes(tag))
   );
+  if (json) return printJson(jobs);
   console.log(catalogInfoLine());
   console.log();
   if (!jobs.length) {
@@ -148,15 +124,20 @@ function list() {
 }
 
 function show(id) {
-  console.log(readFileSync(join(ROOT, findJob(id).path), "utf8"));
+  const meta = findJob(id);
+  const raw = readFileSync(join(ROOT, meta.path), "utf8");
+  if (hasFlag("json")) return printJson(yaml.load(raw));
+  console.log(raw);
 }
 
 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 })));
   console.log(catalogInfoLine());
   console.log();
-  for (const [cat, n] of Object.entries(counts).sort(([a], [b]) => a.localeCompare(b))) {
+  for (const [cat, n] of sorted) {
     console.log(`${cat}  (${n})`);
   }
 }

package/catalog.json

@@ -1,7 +1,7 @@
 {
   "generated_by": "scripts/build-catalog.js",
   "schema": "schema/job.schema.json",
-  "count": 182,
+  "count": 189,
   "jobs": [
     {
       "id": "1on1-prep-reminder",
@@ -809,6 +809,31 @@
       ],
       "path": "jobs/learning/course-progress-checkin.yaml"
     },
+    {
+      "id": "court-deadline-reminder",
+      "version": 1,
+      "name": "Court Deadline Reminder",
+      "description": "Checks a tracked list of court/filing deadlines and warns before any come due. Use this if a filing deadline has ever been missed because it lived only in one person's head or a sticky note instead of a shared, checked calendar.",
+      "category": "legal",
+      "tags": [
+        "legal",
+        "court",
+        "deadline",
+        "compliance"
+      ],
+      "schedule": "0 7 * * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/legal/court-deadline-reminder.yaml"
+    },
     {
       "id": "coverage-gap-audit",
       "version": 1,
@@ -1186,6 +1211,31 @@
       ],
       "path": "jobs/devops/docker-image-prune.yaml"
     },
+    {
+      "id": "downloads-folder-auto-organize",
+      "version": 1,
+      "name": "Downloads Folder Auto-Organize",
+      "description": "Sorts files sitting in your downloads folder into subfolders by type (images, documents, archives, installers), so it doesn't turn into an unsearchable pile. Use this if your downloads folder has ever hit hundreds of files with zero structure.",
+      "category": "personal",
+      "tags": [
+        "files",
+        "organization",
+        "downloads",
+        "cleanup"
+      ],
+      "schedule": "0 3 * * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/personal/downloads-folder-auto-organize.yaml"
+    },
     {
       "id": "email-deliverability-check",
       "version": 1,
@@ -1581,6 +1631,33 @@
       ],
       "path": "jobs/hospitality/food-safety-temp-log-check.yaml"
     },
+    {
+      "id": "form-lead-crm-sync-check",
+      "version": 1,
+      "name": "Form Lead CRM Sync Check",
+      "description": "Checks that leads submitted through your web forms actually landed in your CRM, catching a broken integration instead of a slow rep. Use this if a form-to-CRM zap/integration has ever quietly broken and leads piled up on the form provider's side while sales thought the pipeline was just empty.",
+      "category": "sales",
+      "tags": [
+        "sales",
+        "leads",
+        "crm",
+        "integration"
+      ],
+      "schedule": "*/30 * * * *",
+      "timezone": "UTC",
+      "runner": "agent-prompt",
+      "modes": [
+        "agent-prompt"
+      ],
+      "compatible_agents": [
+        "claude",
+        "codex",
+        "hermes",
+        "openclaw",
+        "generic"
+      ],
+      "path": "jobs/sales/form-lead-crm-sync-check.yaml"
+    },
     {
       "id": "freight-rate-spike-watch",
       "version": 1,
@@ -2333,12 +2410,12 @@
       "id": "low-stock-alert",
       "version": 1,
       "name": "Low Stock Alert",
-      "description": "Checks inventory levels against a reorder point and flags SKUs running low. Use this if you've ever gone out of stock on a bestseller because nobody was watching the count.",
+      "description": "Checks a general-purpose inventory database (warehouse, retail backroom, restaurant supplies — anything with a quantity and a set reorder point) against that fixed threshold and flags what's running low. Use this for physical stock tracked in a database, not tied to online sales; if you specifically need SKU reorder timing driven by e-commerce sales velocity and supplier lead time, see `low-stock-reorder-alert` instead.",
       "category": "inventory",
       "tags": [
         "inventory",
         "stock",
-        "ecommerce"
+        "warehouse"
       ],
       "schedule": "0 7 * * *",
       "timezone": "UTC",
@@ -2980,6 +3057,31 @@
       ],
       "path": "jobs/manufacturing/production-line-downtime-watch.yaml"
     },
+    {
+      "id": "property-maintenance-inspection-reminder",
+      "version": 1,
+      "name": "Property Maintenance Inspection Reminder",
+      "description": "Tracks when each property was last inspected and flags any that are due for their next routine walkthrough. Use this if a property has ever gone a year or more without a proper inspection because nothing forced anyone to schedule one.",
+      "category": "realestate",
+      "tags": [
+        "realestate",
+        "maintenance",
+        "inspection",
+        "property"
+      ],
+      "schedule": "0 8 * * 1",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/realestate/property-maintenance-inspection-reminder.yaml"
+    },
     {
       "id": "pto-balance-check",
       "version": 1,
@@ -3397,6 +3499,33 @@
       ],
       "path": "jobs/content/rss-feed-validate.yaml"
     },
+    {
+      "id": "rss-to-social-repurpose",
+      "version": 1,
+      "name": "RSS-to-Social Repurpose Draft",
+      "description": "Checks your blog/RSS feed for new posts and drafts a set of social posts repurposing each one, instead of publishing and moving on without ever promoting it. Use this if you've ever shipped a blog post and then simply forgot to tell anyone it existed.",
+      "category": "content",
+      "tags": [
+        "content",
+        "rss",
+        "social",
+        "repurposing"
+      ],
+      "schedule": "0 10 * * *",
+      "timezone": "UTC",
+      "runner": "agent-prompt",
+      "modes": [
+        "agent-prompt"
+      ],
+      "compatible_agents": [
+        "claude",
+        "codex",
+        "hermes",
+        "openclaw",
+        "generic"
+      ],
+      "path": "jobs/content/rss-to-social-repurpose.yaml"
+    },
     {
       "id": "rsvp-followup-reminder",
       "version": 1,
@@ -4535,6 +4664,60 @@
         "generic"
       ],
       "path": "jobs/productivity/weekly-report.yaml"
+    },
+    {
+      "id": "welcome-email-drip-check",
+      "version": 1,
+      "name": "Welcome Email Drip Check",
+      "description": "Checks that everyone who signed up recently actually received the welcome email, and flags anyone who fell through the cracks. Use this if a welcome-email automation has ever silently failed for a batch of new users and nobody noticed until support tickets started asking \"where's my onboarding email?\"",
+      "category": "growth",
+      "tags": [
+        "growth",
+        "email",
+        "onboarding",
+        "welcome-email"
+      ],
+      "schedule": "0 10 * * *",
+      "timezone": "UTC",
+      "runner": "agent-prompt",
+      "modes": [
+        "agent-prompt"
+      ],
+      "compatible_agents": [
+        "claude",
+        "codex",
+        "hermes",
+        "openclaw",
+        "generic"
+      ],
+      "path": "jobs/growth/welcome-email-drip-check.yaml"
+    },
+    {
+      "id": "youtube-clip-repurposing",
+      "version": 1,
+      "name": "YouTube Clip Repurposing Draft",
+      "description": "Checks for a newly published long-form video and drafts a shortlist of moments worth cutting into shorts/clips for other platforms. Use this if a video has ever gone up and just sat there as one long upload instead of becoming five pieces of content.",
+      "category": "creator",
+      "tags": [
+        "youtube",
+        "video",
+        "clips",
+        "repurposing"
+      ],
+      "schedule": "0 12 * * *",
+      "timezone": "UTC",
+      "runner": "agent-prompt",
+      "modes": [
+        "agent-prompt"
+      ],
+      "compatible_agents": [
+        "claude",
+        "codex",
+        "hermes",
+        "openclaw",
+        "generic"
+      ],
+      "path": "jobs/creator/youtube-clip-repurposing.yaml"
     }
   ]
 }

package/jobs/content/rss-to-social-repurpose.yaml

@@ -0,0 +1,36 @@
+id: rss-to-social-repurpose
+version: 1
+name: RSS-to-Social Repurpose Draft
+description: >
+  Checks your blog/RSS feed for new posts and drafts a set of social posts
+  repurposing each one, instead of publishing and moving on without ever
+  promoting it. Use this if you've ever shipped a blog post and then simply
+  forgot to tell anyone it existed.
+category: content
+tags: [content, rss, social, repurposing]
+schedule: "0 10 * * *"
+timezone: "UTC"
+runner: agent-prompt
+prompt: |
+  Check {{feed_url}} for posts published in the last {{lookback_hours}}
+  hours.
+  1. For each new post, read the title/summary (fetch the full post if the
+     feed only has a snippet).
+  2. Draft {{platforms}} versions: a short one for X/Bluesky-style
+     character limits, and a longer one for LinkedIn-style posts — each
+     written to stand alone, not just "new post: [link]".
+  3. Suggest one pull-quote or stat from the post that would work as a
+     standalone hook.
+  4. If no new posts, say so in one line.
+variables:
+  feed_url:
+    default: "https://example.com/rss.xml"
+    description: URL of the RSS/Atom feed to check.
+  lookback_hours:
+    default: 24
+    description: How far back to check for new posts.
+  platforms:
+    default: "X, LinkedIn"
+    description: Comma-separated list of platforms to draft posts for.
+compatible_agents: [claude, codex, hermes, openclaw, generic]
+notes: Draft-only — review before posting, and adjust tone/length per platform's actual current norms rather than trusting fixed character-count assumptions.

package/jobs/creator/youtube-clip-repurposing.yaml

@@ -0,0 +1,37 @@
+id: youtube-clip-repurposing
+version: 1
+name: YouTube Clip Repurposing Draft
+description: >
+  Checks for a newly published long-form video and drafts a shortlist of
+  moments worth cutting into shorts/clips for other platforms. Use this if
+  a video has ever gone up and just sat there as one long upload instead of
+  becoming five pieces of content.
+category: creator
+tags: [youtube, video, clips, repurposing]
+schedule: "0 12 * * *"
+timezone: "UTC"
+runner: agent-prompt
+prompt: |
+  Check {{channel_url}} for videos published in the last
+  {{lookback_hours}} hours.
+  1. For any new video, pull the transcript/chapters if available.
+  2. Identify {{clip_count}} moments (with approximate timestamps) that
+     would work as standalone short-form clips — look for a strong hook in
+     the first few seconds, a self-contained point, or a punchy reaction.
+  3. Draft a one-line caption per clip suited for {{short_platforms}}.
+  4. If no new video, say so in one line.
+variables:
+  channel_url:
+    default: "https://www.youtube.com/@yourchannel"
+    description: Channel or specific video URL to check.
+  lookback_hours:
+    default: 24
+    description: How far back to check for a new upload.
+  clip_count:
+    default: 3
+    description: How many clip candidates to suggest per video.
+  short_platforms:
+    default: "YouTube Shorts, TikTok, Instagram Reels"
+    description: Comma-separated short-form platforms to caption for.
+compatible_agents: [claude, codex, hermes, openclaw, generic]
+notes: Suggests timestamps and captions only — actual cutting/editing still needs a video tool; this just removes the "which moments are worth clipping" decision.

package/jobs/growth/welcome-email-drip-check.yaml

@@ -0,0 +1,36 @@
+id: welcome-email-drip-check
+version: 1
+name: Welcome Email Drip Check
+description: >
+  Checks that everyone who signed up recently actually received the
+  welcome email, and flags anyone who fell through the cracks. Use this if
+  a welcome-email automation has ever silently failed for a batch of new
+  users and nobody noticed until support tickets started asking "where's
+  my onboarding email?"
+category: growth
+tags: [growth, email, onboarding, welcome-email]
+schedule: "0 10 * * *"
+timezone: "UTC"
+runner: agent-prompt
+prompt: |
+  Check {{signup_source}} for accounts created in the last
+  {{lookback_hours}} hours, and cross-reference against
+  {{email_platform}} send logs for the welcome email campaign.
+  1. List any new signup with no corresponding welcome email send logged.
+  2. Note how long ago they signed up, sorted oldest-first.
+  3. If any gap is found, flag whether it looks like an isolated miss or a
+     systemic failure (e.g. every signup in a time window is missing it,
+     which points at the automation itself breaking).
+  4. If everyone got their email, say so in one line.
+variables:
+  signup_source:
+    default: "your user database or signup form"
+    description: Where new signups are recorded.
+  email_platform:
+    default: "your transactional email platform (e.g. Postmark, SendGrid, Customer.io)"
+    description: Where welcome-email sends are logged.
+  lookback_hours:
+    default: 24
+    description: How far back to check for new signups.
+compatible_agents: [claude, codex, hermes, openclaw, generic]
+notes: Read-only check — wire up a manual resend for anyone flagged rather than having this job send email directly.

package/jobs/inventory/low-stock-alert.yaml

@@ -2,11 +2,14 @@ id: low-stock-alert
 version: 1
 name: Low Stock Alert
 description: >
-  Checks inventory levels against a reorder point and flags SKUs running
-  low. Use this if you've ever gone out of stock on a bestseller because
-  nobody was watching the count.
+  Checks a general-purpose inventory database (warehouse, retail backroom,
+  restaurant supplies — anything with a quantity and a set reorder point)
+  against that fixed threshold and flags what's running low. Use this for
+  physical stock tracked in a database, not tied to online sales; if you
+  specifically need SKU reorder timing driven by e-commerce sales velocity
+  and supplier lead time, see `low-stock-reorder-alert` instead.
 category: inventory
-tags: [inventory, stock, ecommerce]
+tags: [inventory, stock, warehouse]
 schedule: "0 7 * * *"
 timezone: "UTC"
 runner: shell

package/jobs/legal/court-deadline-reminder.yaml

@@ -0,0 +1,40 @@
+id: court-deadline-reminder
+version: 1
+name: Court Deadline Reminder
+description: >
+  Checks a tracked list of court/filing deadlines and warns before any come
+  due. Use this if a filing deadline has ever been missed because it lived
+  only in one person's head or a sticky note instead of a shared, checked
+  calendar.
+category: legal
+tags: [legal, court, deadline, compliance]
+schedule: "0 7 * * *"
+timezone: "UTC"
+runner: shell
+command: >
+  awk -F',' -v days="{{warn_days_before}}" '
+    NR==1 {next}
+    {
+      cmd = "date -d \"" $3 "\" +%s 2>/dev/null || date -j -f %Y-%m-%d \"" $3 "\" +%s 2>/dev/null";
+      cmd | getline due_epoch; close(cmd);
+      "date +%s" | getline now_epoch; close("date +%s");
+      diff_days = (due_epoch - now_epoch) / 86400;
+      if (diff_days <= days && diff_days >= 0) {
+        printf "DUE SOON: %s — %s due %s (%d days)\n", $1, $2, $3, diff_days;
+      }
+    }
+  ' "{{deadlines_csv_path}}"
+variables:
+  deadlines_csv_path:
+    default: "./court-deadlines.csv"
+    description: "Path to a CSV with columns: matter_name,deadline_type,due_date (YYYY-MM-DD) — e.g. one row per filing/response/statute-of-limitations deadline."
+  warn_days_before:
+    default: 14
+    description: How many days before a deadline to start warning.
+compatible_agents: [generic, claude, codex]
+notes: >
+  This is a plain date-threshold check, not a rules-based calendaring
+  engine — it won't calculate deadlines from court rules the way dedicated
+  legal calendaring software does. Export computed due dates from that
+  system into the CSV, or maintain them manually, and use this as the
+  "did anyone actually notice" backstop.

package/jobs/personal/downloads-folder-auto-organize.yaml

@@ -0,0 +1,34 @@
+id: downloads-folder-auto-organize
+version: 1
+name: Downloads Folder Auto-Organize
+description: >
+  Sorts files sitting in your downloads folder into subfolders by type
+  (images, documents, archives, installers), so it doesn't turn into an
+  unsearchable pile. Use this if your downloads folder has ever hit
+  hundreds of files with zero structure.
+category: personal
+tags: [files, organization, downloads, cleanup]
+schedule: "0 3 * * *"
+timezone: "UTC"
+runner: shell
+command: >
+  dir="{{downloads_dir}}";
+  cd "$dir" || exit 1;
+  mkdir -p images documents archives installers other;
+  for f in *; do
+    [ -f "$f" ] || continue;
+    case "$f" in
+      *.jpg|*.jpeg|*.png|*.gif|*.webp|*.heic) mv -n "$f" images/ ;;
+      *.pdf|*.doc|*.docx|*.txt|*.md|*.xlsx|*.csv) mv -n "$f" documents/ ;;
+      *.zip|*.tar|*.gz|*.7z|*.rar) mv -n "$f" archives/ ;;
+      *.dmg|*.pkg|*.exe|*.msi|*.deb) mv -n "$f" installers/ ;;
+      *) mv -n "$f" other/ ;;
+    esac;
+  done;
+  echo "sorted $(find images documents archives installers other -type f 2>/dev/null | wc -l) file(s) in $dir"
+variables:
+  downloads_dir:
+    default: "$HOME/Downloads"
+    description: Path to the downloads folder to organize.
+compatible_agents: [generic, claude, codex]
+notes: Only sorts files sitting directly in the folder (not subfolders you've already made), and never overwrites a same-named file already in the destination (`mv -n`).

package/jobs/realestate/property-maintenance-inspection-reminder.yaml

@@ -0,0 +1,35 @@
+id: property-maintenance-inspection-reminder
+version: 1
+name: Property Maintenance Inspection Reminder
+description: >
+  Tracks when each property was last inspected and flags any that are due
+  for their next routine walkthrough. Use this if a property has ever gone
+  a year or more without a proper inspection because nothing forced anyone
+  to schedule one.
+category: realestate
+tags: [realestate, maintenance, inspection, property]
+schedule: "0 8 * * 1"
+timezone: "UTC"
+runner: shell
+command: >
+  awk -F',' -v days="{{inspection_interval_days}}" '
+    NR==1 {next}
+    {
+      cmd = "date -d \"" $2 "\" +%s 2>/dev/null || date -j -f %Y-%m-%d \"" $2 "\" +%s 2>/dev/null";
+      cmd | getline last_epoch; close(cmd);
+      "date +%s" | getline now_epoch; close("date +%s");
+      days_since = (now_epoch - last_epoch) / 86400;
+      if (days_since >= days) {
+        printf "DUE: %s — last inspected %s (%d days ago)\n", $1, $2, days_since;
+      }
+    }
+  ' "{{properties_csv_path}}"
+variables:
+  properties_csv_path:
+    default: "./property-inspections.csv"
+    description: "Path to a CSV with columns: property_name,last_inspection_date (YYYY-MM-DD)."
+  inspection_interval_days:
+    default: 180
+    description: How often each property should be inspected, in days.
+compatible_agents: [generic, claude, codex]
+notes: Assumes a maintained CSV of last-inspection dates per property — export it from whatever property management system you use, or update it manually after each walkthrough.

package/jobs/sales/form-lead-crm-sync-check.yaml

@@ -0,0 +1,36 @@
+id: form-lead-crm-sync-check
+version: 1
+name: Form Lead CRM Sync Check
+description: >
+  Checks that leads submitted through your web forms actually landed in
+  your CRM, catching a broken integration instead of a slow rep. Use this
+  if a form-to-CRM zap/integration has ever quietly broken and leads piled
+  up on the form provider's side while sales thought the pipeline was just
+  empty.
+category: sales
+tags: [sales, leads, crm, integration]
+schedule: "*/30 * * * *"
+timezone: "UTC"
+runner: agent-prompt
+prompt: |
+  Check {{form_platform}} for form submissions in the last
+  {{lookback_hours}} hours, and check {{crm_platform}} for matching lead
+  records (by email).
+  1. List any form submission with no matching CRM record.
+  2. If there's a gap, note how many are missing and since when — a
+     sudden cluster of misses starting at a specific time usually means
+     the integration itself broke, not that leads are individually
+     falling through.
+  3. If everything matches, say so in one line.
+variables:
+  form_platform:
+    default: "your web form tool (e.g. Typeform, HubSpot forms, a custom form)"
+    description: Where form submissions are recorded.
+  crm_platform:
+    default: "your CRM (e.g. HubSpot, Salesforce, Pipedrive)"
+    description: Where leads should be showing up.
+  lookback_hours:
+    default: 2
+    description: How far back to check for submissions, tight enough to catch a break quickly.
+compatible_agents: [claude, codex, hermes, openclaw, generic]
+notes: Read-only — this catches the gap, but reprocessing missed leads into the CRM is a separate, deliberate action.

package/lib/recommend.js

@@ -0,0 +1,62 @@
+// Scoring logic behind `crondex recommend` — pulled out of bin/crondex.js so it can
+// be unit tested directly (see test/recommend.test.js).
+
+export const STOPWORDS = new Set([
+  "a", "an", "the", "to", "for", "of", "in", "on", "at", "by", "and", "or", "my", "me", "i",
+  "can", "you", "do", "does", "this", "that", "these", "those", "please", "want", "wants",
+  "wanted", "need", "needs", "help", "with", "is", "are", "be", "it", "so", "when", "should",
+  "could", "would", "how", "what", "which", "up", "down", "get", "make", "set", "just", "really",
+  "some", "something", "any", "want", "us", "our", "your", "yours", "if", "then", "than",
+]);
+
+export function stem(word) {
+  if (word.length > 4 && word.endsWith("ies")) return word.slice(0, -3) + "y";
+  if (word.length > 4 && word.endsWith("es") && !word.endsWith("ses")) return word.slice(0, -2);
+  if (word.length > 3 && word.endsWith("s") && !word.endsWith("ss")) return word.slice(0, -1);
+  return 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);
+}
+
+// id and name are near-duplicates of each other (id is just the slugified
+// name), so they're merged into one "title" field — otherwise a match on a
+// shared word like "water" gets weighted 3+3 instead of 3, which can outrank
+// a more specific job that only matches once via tags.
+export const RECOMMEND_WEIGHTS = { tags: 4, title: 3, category: 2, description: 1 };
+
+export function scoreJob(queryTokens, job) {
+  const fields = {
+    tags: job.tags.map((t) => stem(t.toLowerCase())),
+    title: [...new Set([...tokenize(job.name), ...tokenize(job.id.replace(/-/g, " "))])],
+    category: tokenize(job.category ?? ""),
+    description: tokenize(job.description ?? ""),
+  };
+  let score = 0;
+  const matched = new Set();
+  for (const qt of queryTokens) {
+    for (const [field, weight] of Object.entries(RECOMMEND_WEIGHTS)) {
+      if (fields[field].includes(qt)) {
+        score += weight;
+        matched.add(qt);
+      }
+    }
+  }
+  return { score, matchedTerms: [...matched] };
+}
+
+export function rankJobs(jobs, queryText, limit = 5) {
+  const queryTokens = tokenize(queryText);
+  if (!queryTokens.length) return [];
+  return jobs
+    .map((job) => ({ job, ...scoreJob(queryTokens, job) }))
+    .filter((r) => r.score > 0)
+    .sort((a, b) => b.score - a.score)
+    .slice(0, limit);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wonsukchoi/crondex",
-  "version": "0.9.1",
+  "version": "0.11.0",
   "description": "A public directory of pre-made, agent-editable cron jobs.",
   "type": "module",
   "license": "MIT",
@@ -23,6 +23,7 @@
   },
   "files": [
     "bin",
+    "lib",
     "jobs",
     "schema",
     "catalog.json"
@@ -33,10 +34,14 @@
   "scripts": {
     "build-catalog": "node scripts/build-catalog.js",
     "validate": "node scripts/validate-jobs.js",
-    "lint-shell": "node scripts/lint-shell.js"
+    "lint-shell": "node scripts/lint-shell.js",
+    "check-duplicates": "node scripts/check-duplicates.js",
+    "test": "node --test"
   },
-  "devDependencies": {
-    "ajv": "^8.17.1",
+  "dependencies": {
     "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "ajv": "^8.17.1"
   }
 }