@wonsukchoi/crondex 0.9.0 → 0.10.0

package/README.md

@@ -1,97 +1,100 @@
-# 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).
-
-`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.
+- `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
 
-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
+---
 
-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/`.
+## Browse the catalog
+
+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:
+187 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 +103,7 @@ from what's actually in `jobs/`.
 | `finance` | 10 |
 | `fleet` | 3 |
 | `gaming` | 3 |
-| `growth` | 4 |
+| `growth` | 5 |
 | `healthcare` | 3 |
 | `hiring` | 3 |
 | `home` | 5 |
@@ -115,75 +118,41 @@ from what's actually in `jobs/`.
 | `manufacturing` | 3 |
 | `marketing` | 4 |
 | `nonprofit` | 3 |
-| `personal` | 8 |
+| `personal` | 9 |
 | `podcast` | 3 |
 | `productivity` | 9 |
 | `realestate` | 3 |
 | `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/
+├── 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,7 @@
 // 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 { tokenize, rankJobs } from "../lib/recommend.js";
 
 const ROOT = new URL("..", import.meta.url).pathname;
 const CATALOG = JSON.parse(readFileSync(join(ROOT, "catalog.json"), "utf8"));
@@ -44,68 +45,13 @@ Examples:
 `);
 }
 
-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] };
-}
-
 function recommend(queryText) {
   const limit = Number(flag("limit")) || 5;
-  const queryTokens = tokenize(queryText);
-  if (!queryTokens.length) {
+  if (!tokenize(queryText).length) {
     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) {
     console.log(`no confident match for "${queryText}". Run "crondex list" to browse everything.`);
     return;

package/catalog.json

@@ -1,7 +1,7 @@
 {
   "generated_by": "scripts/build-catalog.js",
   "schema": "schema/job.schema.json",
-  "count": 182,
+  "count": 187,
   "jobs": [
     {
       "id": "1on1-prep-reminder",
@@ -258,7 +258,7 @@
     },
     {
       "id": "bill-due-reminder",
-      "version": 1,
+      "version": 2,
       "name": "Bill Due Reminder",
       "description": "Warns you a few days before a recurring monthly bill is due. Use this if you've ever paid a late fee just because you forgot the date.",
       "category": "personal",
@@ -656,7 +656,7 @@
     },
     {
       "id": "competitor-page-diff-watch",
-      "version": 1,
+      "version": 2,
       "name": "Competitor Page Diff Watch",
       "description": "Snapshots a competitor's pricing or landing page and diffs it against the last snapshot, turning any real change into a short action memo instead of a wall of markup diff. Use this if a competitor has ever changed pricing or repositioned a page and you found out from a customer instead of noticing it yourself.",
       "category": "marketing",
@@ -760,7 +760,7 @@
     },
     {
       "id": "cost-alert",
-      "version": 1,
+      "version": 2,
       "name": "Cloud/API Cost Alert",
       "description": "Checks your recent cloud or API spend against a budget and warns you if you're over or on pace to go over. Use this if you've ever been surprised by a bill.",
       "category": "devops",
@@ -1186,6 +1186,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 +1606,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,
@@ -2637,7 +2689,7 @@
     },
     {
       "id": "open-port-check",
-      "version": 1,
+      "version": 2,
       "name": "Expected Open Ports Check",
       "description": "Checks that the ports you expect to be open on a host actually are, and flags any that aren't. Use this if a service has ever silently stopped listening and you found out from a user instead of a monitor.",
       "category": "security",
@@ -3126,7 +3178,7 @@
     },
     {
       "id": "recurring-task-queue-reset",
-      "version": 1,
+      "version": 2,
       "name": "Recurring Task Queue Reset",
       "description": "Clears out last week's completed recurring-task checklist and creates a fresh one from your template, so every cycle starts with the same predefined owners and checklist instead of a copy-pasted mess. Use this if your recurring weekly checklist has ever quietly drifted because someone edited last week's copy instead of starting clean.",
       "category": "productivity",
@@ -3199,7 +3251,7 @@
     },
     {
       "id": "repo-health-check",
-      "version": 1,
+      "version": 2,
       "name": "Git Repo Health Check",
       "description": "Checks a git repo for branches nobody's touched in a while, uncommitted changes sitting around, and pull requests waiting on review, then reports a short digest. Use this if you want a daily nudge on repo hygiene without checking everything by hand.",
       "category": "devops",
@@ -3397,6 +3449,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,
@@ -3973,7 +4052,7 @@
     },
     {
       "id": "subscription-price-hike-watch",
-      "version": 1,
+      "version": 2,
       "name": "Subscription Price Hike Watch",
       "description": "Checks a tracked subscription's current price against the last price you recorded and flags any increase. Use this if a service has ever quietly raised its price and you only noticed months later scrolling through a bank statement.",
       "category": "finance",
@@ -4535,6 +4614,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/devops/cost-alert.yaml

@@ -1,5 +1,5 @@
 id: cost-alert
-version: 1
+version: 2
 name: Cloud/API Cost Alert
 description: >
   Checks your recent cloud or API spend against a budget and warns you if
@@ -14,7 +14,7 @@ command: >
   if command -v aws >/dev/null 2>&1; then
     start=$(date -d "-{{lookback_days}} days" +%Y-%m-%d 2>/dev/null || date -v-{{lookback_days}}d +%Y-%m-%d);
     end=$(date +%Y-%m-%d);
-    aws ce get-cost-and-usage --time-period Start=$start,End=$end --granularity DAILY --metrics UnblendedCost 2>/dev/null || echo "aws cost explorer call failed (check credentials/permissions)";
+    aws ce get-cost-and-usage --time-period Start="$start",End="$end" --granularity DAILY --metrics UnblendedCost 2>/dev/null || echo "aws cost explorer call failed (check credentials/permissions)";
   elif command -v vercel >/dev/null 2>&1; then
     vercel billing 2>/dev/null || echo "vercel CLI present but no billing subcommand available";
   else

package/jobs/devops/repo-health-check.yaml

@@ -1,5 +1,5 @@
 id: repo-health-check
-version: 1
+version: 2
 name: Git Repo Health Check
 description: >
   Checks a git repo for branches nobody's touched in a while, uncommitted
@@ -15,7 +15,7 @@ command: >
   cd {{repo_path}} && now=$(date +%s) &&
   echo "--- branches stale >{{stale_branch_days}}d ---" &&
   git for-each-ref --format='%(committerdate:unix) %(refname:short)' refs/heads/ |
-    while read ts name; do age=$(( (now-ts)/86400 )); [ "$age" -gt {{stale_branch_days}} ] && echo "$name: ${age}d"; done;
+    while read -r ts name; do age=$(( (now-ts)/86400 )); [ "$age" -gt {{stale_branch_days}} ] && echo "$name: ${age}d"; done;
   echo "--- uncommitted changes ---"; git status --short;
   command -v gh >/dev/null && { echo "--- open PRs ---"; gh pr list --state open; } || echo "(gh not installed, skipping PR check)"
 prompt: |

package/jobs/finance/subscription-price-hike-watch.yaml

@@ -1,5 +1,5 @@
 id: subscription-price-hike-watch
-version: 1
+version: 2
 name: Subscription Price Hike Watch
 description: >
   Checks a tracked subscription's current price against the last price you
@@ -18,7 +18,7 @@ command: >
   if [ -z "$current_price" ]; then
     echo "could not extract a price from {{pricing_page_url}} — check {{price_pattern}} still matches the page.";
     exit 0;
-  fi
+  fi;
   last_price=$(tail -1 "$history_file" | cut -d',' -f2);
   today=$(date +%Y-%m-%d);
   echo "$today,$current_price" >> "$history_file";

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/marketing/competitor-page-diff-watch.yaml

@@ -1,5 +1,5 @@
 id: competitor-page-diff-watch
-version: 1
+version: 2
 name: Competitor Page Diff Watch
 description: >
   Snapshots a competitor's pricing or landing page and diffs it against the
@@ -17,7 +17,11 @@ command: >
   mkdir -p "$snapshot_dir";
   today_file="$snapshot_dir/$(date +%Y-%m-%d).html";
   curl -s -A "Mozilla/5.0" "{{competitor_url}}" -o "$today_file";
-  prev_file=$(ls -1 "$snapshot_dir" | grep -v "$(basename "$today_file")" | sort | tail -1);
+  prev_file="";
+  for f in "$snapshot_dir"/*.html; do
+    [ "$(basename "$f")" = "$(basename "$today_file")" ] && continue;
+    prev_file=$(basename "$f");
+  done;
   if [ -n "$prev_file" ]; then
     diff "$snapshot_dir/$prev_file" "$today_file" | head -100;
   else

package/jobs/personal/bill-due-reminder.yaml

@@ -1,5 +1,5 @@
 id: bill-due-reminder
-version: 1
+version: 2
 name: Bill Due Reminder
 description: >
   Warns you a few days before a recurring monthly bill is due. Use this if
@@ -13,7 +13,7 @@ command: >
   due={{due_day_of_month}}; warn={{warn_days}}; name="{{bill_name}}";
   today=$(date +%-d);
   days_left=$(( due - today ));
-  if [ "$days_left" -lt 0 ]; then days_left=$(( days_left + 30 )); fi
+  if [ "$days_left" -lt 0 ]; then days_left=$(( days_left + 30 )); fi;
   if [ "$days_left" -le "$warn" ]; then echo "REMINDER: $name due in $days_left day(s) (on day $due of the month)";
   else echo "OK: $name due in $days_left day(s)"; fi
 variables:

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/productivity/recurring-task-queue-reset.yaml

@@ -1,5 +1,5 @@
 id: recurring-task-queue-reset
-version: 1
+version: 2
 name: Recurring Task Queue Reset
 description: >
   Clears out last week's completed recurring-task checklist and creates a
@@ -16,7 +16,7 @@ command: >
   if [ ! -f "{{template_path}}" ]; then
     echo "template not found at {{template_path}} — nothing to reset from.";
     exit 1;
-  fi
+  fi;
   week_label=$(date +%G-W%V);
   dest="{{output_dir}}/${week_label}.md";
   mkdir -p "{{output_dir}}";

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/jobs/security/open-port-check.yaml

@@ -1,5 +1,5 @@
 id: open-port-check
-version: 1
+version: 2
 name: Expected Open Ports Check
 description: >
   Checks that the ports you expect to be open on a host actually are, and
@@ -16,7 +16,7 @@ command: >
     if command -v nc >/dev/null 2>&1; then
       nc -z -w2 "$host" "$p" 2>/dev/null && echo "OK: $host:$p open" || { echo "MISSING: $host:$p expected open but isn't"; fail=1; };
     else
-      (echo > /dev/tcp/$host/$p) 2>/dev/null && echo "OK: $host:$p open" || { echo "MISSING: $host:$p expected open but isn't"; fail=1; };
+      (echo > "/dev/tcp/$host/$p") 2>/dev/null && echo "OK: $host:$p open" || { echo "MISSING: $host:$p expected open but isn't"; fail=1; };
     fi
   done;
   exit $fail

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.0",
+  "version": "0.10.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"
@@ -32,7 +33,9 @@
   },
   "scripts": {
     "build-catalog": "node scripts/build-catalog.js",
-    "validate": "node scripts/validate-jobs.js"
+    "validate": "node scripts/validate-jobs.js",
+    "lint-shell": "node scripts/lint-shell.js",
+    "test": "node --test"
   },
   "devDependencies": {
     "ajv": "^8.17.1",