@wonsukchoi/crondex 0.4.0 → 0.5.0

package/README.md

@@ -63,7 +63,10 @@ crondex/
 │   ├── finance/
 │   ├── security/
 │   ├── learning/
-│   └── team/
+│   ├── team/
+│   ├── home/
+│   ├── travel/
+│   └── growth/
 └── scripts/
     ├── build-catalog.js   regenerates catalog.json from jobs/**/*.yaml
     └── validate-jobs.js   validates every job against the schema
@@ -71,7 +74,7 @@ crondex/
 
 ## Available jobs
 
-46 jobs across 8 categories. Full details (description, tags, variables)
+56 jobs across 11 categories. Full details (description, tags, variables)
 live in `catalog.json` and each job's YAML file — run `crondex list` or
 browse `jobs/<category>/` for the plain-language rundown of each.
 
@@ -125,6 +128,7 @@ browse `jobs/<category>/` for the plain-language rundown of each.
 | `social-mentions-watch` | `0 9 * * *` | agent-prompt only |
 | `seo-meta-check` | `0 7 * * 1` | script |
 | `rss-feed-validate` | `0 8 * * *` | script |
+| `robots-txt-check` | `0 8 * * *` | script |
 
 **finance**
 
@@ -145,6 +149,7 @@ browse `jobs/<category>/` for the plain-language rundown of each.
 | `failed-login-watch` | `*/15 * * * *` | script |
 | `sudo-usage-audit` | `0 * * * *` | script |
 | `firewall-rule-diff` | `0 6 * * *` | script |
+| `certificate-transparency-watch` | `0 */12 * * *` | script |
 
 **learning**
 
@@ -161,6 +166,29 @@ browse `jobs/<category>/` for the plain-language rundown of each.
 | `1on1-prep-reminder` | `0 9 * * 3` | script |
 | `pto-balance-check` | `0 9 1 * *` | script |
 
+**home**
+
+| id | schedule | modes |
+|---|---|---|
+| `hvac-filter-reminder` | `0 9 1 * *` | script |
+| `smoke-detector-battery-check` | `0 9 1 * *` | script |
+| `plant-watering-reminder` | `0 9 * * *` | script |
+
+**travel**
+
+| id | schedule | modes |
+|---|---|---|
+| `passport-expiry-check` | `0 9 1 * *` | script |
+| `visa-expiry-check` | `0 9 1 * *` | script |
+| `flight-checkin-reminder` | `0 * * * *` | script |
+
+**growth**
+
+| id | schedule | modes |
+|---|---|---|
+| `review-request-nudge` | `0 9 * * *` | script |
+| `cart-abandonment-followup` | `0 10 * * *` | script + agent-prompt |
+
 ## How a job works
 
 Every job is one YAML file with a `runner`:

package/catalog.json

@@ -1,7 +1,7 @@
 {
   "generated_by": "scripts/build-catalog.js",
   "schema": "schema/job.schema.json",
-  "count": 46,
+  "count": 56,
   "jobs": [
     {
       "id": "1on1-prep-reminder",
@@ -123,6 +123,57 @@
       ],
       "path": "jobs/content/broken-link-check.yaml"
     },
+    {
+      "id": "cart-abandonment-followup",
+      "version": 1,
+      "name": "Cart Abandonment Follow-up",
+      "description": "Finds abandoned shopping carts old enough to follow up on, and can draft the follow-up email for you. Use this if abandoned-cart recovery is something you know you should do but never get to.",
+      "category": "growth",
+      "tags": [
+        "growth",
+        "ecommerce",
+        "cart-recovery"
+      ],
+      "schedule": "0 10 * * *",
+      "timezone": "UTC",
+      "runner": "hybrid",
+      "modes": [
+        "script",
+        "agent-prompt"
+      ],
+      "compatible_agents": [
+        "claude",
+        "codex",
+        "hermes",
+        "openclaw",
+        "generic"
+      ],
+      "path": "jobs/growth/cart-abandonment-followup.yaml"
+    },
+    {
+      "id": "certificate-transparency-watch",
+      "version": 1,
+      "name": "Certificate Transparency Watch",
+      "description": "Checks public Certificate Transparency logs for new TLS certs issued for your domain and flags any you didn't expect. Use this if you want an early warning for someone issuing a cert for your domain without your knowledge (a common precursor to phishing/MITM setups).",
+      "category": "security",
+      "tags": [
+        "security",
+        "tls",
+        "certificate-transparency"
+      ],
+      "schedule": "0 */12 * * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/security/certificate-transparency-watch.yaml"
+    },
     {
       "id": "changelog-digest",
       "version": 1,
@@ -447,6 +498,30 @@
       ],
       "path": "jobs/security/firewall-rule-diff.yaml"
     },
+    {
+      "id": "flight-checkin-reminder",
+      "version": 1,
+      "name": "Flight Check-in Reminder",
+      "description": "Reminds you when online check-in opens for an upcoming flight. Use this if you've ever missed the good seats because check-in opened while you were asleep.",
+      "category": "travel",
+      "tags": [
+        "travel",
+        "flight",
+        "reminder"
+      ],
+      "schedule": "0 * * * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/travel/flight-checkin-reminder.yaml"
+    },
     {
       "id": "focus-block-reminder",
       "version": 1,
@@ -495,6 +570,30 @@
       ],
       "path": "jobs/personal/habit-checkin.yaml"
     },
+    {
+      "id": "hvac-filter-reminder",
+      "version": 1,
+      "name": "HVAC Filter Change Reminder",
+      "description": "Reminds you to change your HVAC filter based on how long it's been. Use this if you've ever found a filter so clogged you forgot it was ever white.",
+      "category": "home",
+      "tags": [
+        "home",
+        "hvac",
+        "maintenance"
+      ],
+      "schedule": "0 9 1 * *",
+      "timezone": "America/Los_Angeles",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/home/hvac-filter-reminder.yaml"
+    },
     {
       "id": "inbox-triage",
       "version": 1,
@@ -691,6 +790,54 @@
       ],
       "path": "jobs/devops/orphaned-branch-cleanup.yaml"
     },
+    {
+      "id": "passport-expiry-check",
+      "version": 1,
+      "name": "Passport Expiry Check",
+      "description": "Warns you before your passport expires — including the \"6 months validity required\" rule many countries enforce at the border. Use this if you've ever booked a trip and only checked your passport date after buying the ticket.",
+      "category": "travel",
+      "tags": [
+        "travel",
+        "passport",
+        "documents"
+      ],
+      "schedule": "0 9 1 * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/travel/passport-expiry-check.yaml"
+    },
+    {
+      "id": "plant-watering-reminder",
+      "version": 1,
+      "name": "Plant Watering Reminder",
+      "description": "Reminds you to water a specific plant once it's due. Use this if you've ever lost a plant to \"I'll water it tomorrow.\"",
+      "category": "home",
+      "tags": [
+        "home",
+        "plants",
+        "reminder"
+      ],
+      "schedule": "0 9 * * *",
+      "timezone": "America/Los_Angeles",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/home/plant-watering-reminder.yaml"
+    },
     {
       "id": "pto-balance-check",
       "version": 1,
@@ -790,6 +937,54 @@
       ],
       "path": "jobs/devops/repo-health-check.yaml"
     },
+    {
+      "id": "review-request-nudge",
+      "version": 1,
+      "name": "Review Request Nudge",
+      "description": "Flags customers who bought a while ago and haven't been asked for a review yet. Use this if review requests only happen when someone remembers to send them.",
+      "category": "growth",
+      "tags": [
+        "growth",
+        "reviews",
+        "ecommerce"
+      ],
+      "schedule": "0 9 * * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/growth/review-request-nudge.yaml"
+    },
+    {
+      "id": "robots-txt-check",
+      "version": 1,
+      "name": "Robots.txt Blanket-Block Check",
+      "description": "Checks that your robots.txt hasn't accidentally blocked every crawler from your entire site. Use this if a robots.txt edit has ever accidentally tanked your search traffic.",
+      "category": "content",
+      "tags": [
+        "seo",
+        "robots",
+        "crawlability"
+      ],
+      "schedule": "0 8 * * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/content/robots-txt-check.yaml"
+    },
     {
       "id": "rss-feed-validate",
       "version": 1,
@@ -913,6 +1108,30 @@
       ],
       "path": "jobs/content/seo-meta-check.yaml"
     },
+    {
+      "id": "smoke-detector-battery-check",
+      "version": 1,
+      "name": "Smoke Detector Battery Check Reminder",
+      "description": "Reminds you to test/replace smoke detector batteries on a schedule. Use this if the only time you think about smoke detectors is when one starts chirping at 3am.",
+      "category": "home",
+      "tags": [
+        "home",
+        "safety",
+        "maintenance"
+      ],
+      "schedule": "0 9 1 * *",
+      "timezone": "America/Los_Angeles",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/home/smoke-detector-battery-check.yaml"
+    },
     {
       "id": "social-mentions-watch",
       "version": 1,
@@ -1084,6 +1303,30 @@
       ],
       "path": "jobs/devops/uptime-ping-check.yaml"
     },
+    {
+      "id": "visa-expiry-check",
+      "version": 1,
+      "name": "Visa/Residency Document Expiry Check",
+      "description": "Warns you before a visa, residency permit, or similar document expires. Use this if you're living or working abroad and a document deadline has ever crept up on you.",
+      "category": "travel",
+      "tags": [
+        "travel",
+        "visa",
+        "documents"
+      ],
+      "schedule": "0 9 1 * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/travel/visa-expiry-check.yaml"
+    },
     {
       "id": "water-intake-reminder",
       "version": 1,

package/jobs/content/robots-txt-check.yaml

@@ -0,0 +1,30 @@
+id: robots-txt-check
+version: 1
+name: Robots.txt Blanket-Block Check
+description: >
+  Checks that your robots.txt hasn't accidentally blocked every
+  crawler from your entire site. Use this if a robots.txt edit has
+  ever accidentally tanked your search traffic.
+category: content
+tags: [seo, robots, crawlability]
+schedule: "0 8 * * *"
+timezone: "UTC"
+runner: shell
+command: >
+  url={{robots_url}};
+  body=$(curl -sL --max-time 10 "$url");
+  [ -z "$body" ] && { echo "ERROR: could not fetch $url"; exit 1; };
+  if echo "$body" | grep -qiE "^Disallow:[[:space:]]*/[[:space:]]*$"; then
+    echo "WARNING: $url has a blanket 'Disallow: /' — this blocks all crawlers from the whole site.";
+    exit 1;
+  else
+    echo "OK: no blanket disallow-all rule found in $url";
+  fi
+variables:
+  robots_url:
+    default: "https://example.com/robots.txt"
+    description: Full URL to your site's robots.txt.
+compatible_agents: [generic, claude, codex]
+notes: >
+  Zero-token. Only checks for the "block everything" footgun, not full
+  robots.txt correctness.

package/jobs/growth/cart-abandonment-followup.yaml

@@ -0,0 +1,46 @@
+id: cart-abandonment-followup
+version: 1
+name: Cart Abandonment Follow-up
+description: >
+  Finds abandoned shopping carts old enough to follow up on, and can
+  draft the follow-up email for you. Use this if abandoned-cart
+  recovery is something you know you should do but never get to.
+category: growth
+tags: [growth, ecommerce, cart-recovery]
+schedule: "0 10 * * *"
+timezone: "UTC"
+runner: hybrid
+command: >
+  file={{carts_file}}; wait_hours={{wait_hours}};
+  [ -f "$file" ] || { echo "ERROR: $file not found"; exit 1; };
+  now=$(date +%s);
+  tail -n +2 "$file" | while IFS=, read -r id email items abandoned followed; do
+    [ "$followed" = "yes" ] && continue;
+    a_epoch=$(date -d "$abandoned" +%s 2>/dev/null || date -j -f "%Y-%m-%d %H:%M" "$abandoned" +%s 2>/dev/null);
+    hours=$(( (now-a_epoch)/3600 ));
+    if [ "$hours" -ge "$wait_hours" ]; then echo "ABANDONED: cart $id ($email) - items: $items - ${hours}h ago"; fi
+  done
+prompt: |
+  Look at carts abandoned more than {{wait_hours}} hours ago in
+  {{carts_file}} (CSV: cart_id,customer_email,items,abandoned_at,followed_up).
+  For each one not yet followed up:
+  1. Draft a short, friendly follow-up email offering help or a gentle
+     nudge to complete checkout.
+  2. Keep it under 100 words, no hard-sell tone.
+script_note: >
+  `command` lists which carts are abandoned and old enough to follow up
+  on, zero tokens. `prompt` actually drafts the follow-up email copy for
+  each one.
+variables:
+  carts_file:
+    default: "./abandoned-carts.csv"
+    description: >
+      CSV with header "cart_id,customer_email,items,abandoned_at,followed_up"
+      (abandoned_at is "YYYY-MM-DD HH:MM", followed_up is yes/no).
+  wait_hours:
+    default: 24
+    description: Wait this many hours after abandonment before flagging for follow-up.
+compatible_agents: [claude, codex, hermes, openclaw, generic]
+notes: >
+  You maintain abandoned-carts.csv yourself (or export it from your store
+  platform) — mark followed_up=yes after sending.

package/jobs/growth/review-request-nudge.yaml

@@ -0,0 +1,35 @@
+id: review-request-nudge
+version: 1
+name: Review Request Nudge
+description: >
+  Flags customers who bought a while ago and haven't been asked for a
+  review yet. Use this if review requests only happen when someone
+  remembers to send them.
+category: growth
+tags: [growth, reviews, ecommerce]
+schedule: "0 9 * * *"
+timezone: "UTC"
+runner: shell
+command: >
+  file={{orders_file}}; wait_days={{wait_days}};
+  [ -f "$file" ] || { echo "ERROR: $file not found"; exit 1; };
+  today=$(date +%s);
+  tail -n +2 "$file" | while IFS=, read -r id customer purchased requested; do
+    [ "$requested" = "yes" ] && continue;
+    p_epoch=$(date -j -f %Y-%m-%d "$purchased" +%s 2>/dev/null || date -d "$purchased" +%s);
+    days=$(( (today-p_epoch)/86400 ));
+    if [ "$days" -ge "$wait_days" ]; then echo "SEND REVIEW REQUEST: order $id ($customer), purchased $days day(s) ago"; fi
+  done
+variables:
+  orders_file:
+    default: "./orders.csv"
+    description: >
+      CSV with header "order_id,customer,purchase_date,review_requested"
+      (purchase_date is YYYY-MM-DD, review_requested is yes/no).
+  wait_days:
+    default: 7
+    description: Wait this many days after purchase before flagging for a review request.
+compatible_agents: [generic, claude, codex]
+notes: >
+  Zero-token. You maintain orders.csv yourself (mark review_requested=yes
+  after sending) — doesn't integrate with any store platform directly.

package/jobs/home/hvac-filter-reminder.yaml

@@ -0,0 +1,29 @@
+id: hvac-filter-reminder
+version: 1
+name: HVAC Filter Change Reminder
+description: >
+  Reminds you to change your HVAC filter based on how long it's been.
+  Use this if you've ever found a filter so clogged you forgot it was
+  ever white.
+category: home
+tags: [home, hvac, maintenance]
+schedule: "0 9 1 * *"
+timezone: "America/Los_Angeles"
+runner: shell
+command: >
+  last={{last_changed_date}}; interval={{interval_months}};
+  last_epoch=$(date -j -f %Y-%m-%d "$last" +%s 2>/dev/null || date -d "$last" +%s);
+  today_epoch=$(date +%s);
+  days_since=$(( (today_epoch-last_epoch)/86400 ));
+  interval_days=$(( interval * 30 ));
+  if [ "$days_since" -ge "$interval_days" ]; then echo "REMINDER: HVAC filter last changed $days_since day(s) ago (every ${interval} months) — change it.";
+  else echo "OK: filter changed $days_since day(s) ago, due again around day $interval_days."; fi
+variables:
+  last_changed_date:
+    default: "2026-01-01"
+    description: Date (YYYY-MM-DD) you last changed the filter — update this yourself.
+  interval_months:
+    default: 3
+    description: How often to change the filter, in months.
+compatible_agents: [generic, claude, codex]
+notes: Zero-token. You update last_changed_date yourself each time you actually change it.

package/jobs/home/plant-watering-reminder.yaml

@@ -0,0 +1,30 @@
+id: plant-watering-reminder
+version: 1
+name: Plant Watering Reminder
+description: >
+  Reminds you to water a specific plant once it's due. Use this if
+  you've ever lost a plant to "I'll water it tomorrow."
+category: home
+tags: [home, plants, reminder]
+schedule: "0 9 * * *"
+timezone: "America/Los_Angeles"
+runner: shell
+command: >
+  last={{last_watered_date}}; interval={{water_interval_days}};
+  last_epoch=$(date -j -f %Y-%m-%d "$last" +%s 2>/dev/null || date -d "$last" +%s);
+  today_epoch=$(date +%s);
+  days_since=$(( (today_epoch-last_epoch)/86400 ));
+  if [ "$days_since" -ge "$interval" ]; then echo "REMINDER: water {{plant_name}} ($days_since day(s) since last watering, every $interval day(s)).";
+  else echo "OK: {{plant_name}} watered $days_since day(s) ago, next due in $(( interval - days_since )) day(s)."; fi
+variables:
+  plant_name:
+    default: "your plant"
+    description: Which plant this reminder is for.
+  water_interval_days:
+    default: 7
+    description: How often to water it, in days.
+  last_watered_date:
+    default: "2026-01-01"
+    description: Date (YYYY-MM-DD) you last watered it — update this yourself.
+compatible_agents: [generic, claude, codex]
+notes: Zero-token. One job per plant — copy it and adjust plant_name/interval for each.

package/jobs/home/smoke-detector-battery-check.yaml

@@ -0,0 +1,29 @@
+id: smoke-detector-battery-check
+version: 1
+name: Smoke Detector Battery Check Reminder
+description: >
+  Reminds you to test/replace smoke detector batteries on a schedule.
+  Use this if the only time you think about smoke detectors is when one
+  starts chirping at 3am.
+category: home
+tags: [home, safety, maintenance]
+schedule: "0 9 1 * *"
+timezone: "America/Los_Angeles"
+runner: shell
+command: >
+  last={{last_tested_date}}; interval={{interval_months}};
+  last_epoch=$(date -j -f %Y-%m-%d "$last" +%s 2>/dev/null || date -d "$last" +%s);
+  today_epoch=$(date +%s);
+  days_since=$(( (today_epoch-last_epoch)/86400 ));
+  interval_days=$(( interval * 30 ));
+  if [ "$days_since" -ge "$interval_days" ]; then echo "REMINDER: smoke detectors last tested $days_since day(s) ago (every ${interval} months) — test/replace batteries.";
+  else echo "OK: tested $days_since day(s) ago, due again around day $interval_days."; fi
+variables:
+  last_tested_date:
+    default: "2026-01-01"
+    description: Date (YYYY-MM-DD) you last tested/changed batteries — update this yourself.
+  interval_months:
+    default: 6
+    description: How often to test, in months.
+compatible_agents: [generic, claude, codex]
+notes: Zero-token. You update last_tested_date yourself each time you actually test.

package/jobs/security/certificate-transparency-watch.yaml

@@ -0,0 +1,31 @@
+id: certificate-transparency-watch
+version: 1
+name: Certificate Transparency Watch
+description: >
+  Checks public Certificate Transparency logs for new TLS certs issued
+  for your domain and flags any you didn't expect. Use this if you want
+  an early warning for someone issuing a cert for your domain without
+  your knowledge (a common precursor to phishing/MITM setups).
+category: security
+tags: [security, tls, certificate-transparency]
+schedule: "0 */12 * * *"
+timezone: "UTC"
+runner: shell
+command: >
+  domain={{domain}}; state={{state_file}};
+  current=$(curl -s "https://crt.sh/?q=${domain}&output=json" | grep -o '"id":[0-9]*' | sort -u);
+  if [ ! -f "$state" ]; then echo "$current" > "$state"; echo "no baseline found — saved current cert IDs as the baseline ($(echo "$current" | wc -l | tr -d ' ') certs)"; exit 0; fi;
+  new=$(comm -13 <(sort "$state") <(echo "$current" | sort));
+  if [ -n "$new" ]; then echo "NEW CERT(S) issued for $domain since last check:"; echo "$new"; echo "$current" > "$state";
+  else echo "OK: no new certs for $domain since last check"; fi
+variables:
+  domain:
+    default: "example.com"
+    description: Domain to watch in Certificate Transparency logs.
+  state_file:
+    default: "./.ct-watch-state"
+    description: File this job uses to remember which cert IDs it's already seen.
+compatible_agents: [generic, claude, codex]
+notes: >
+  Zero-token. Uses the public crt.sh API (rate limits may apply).
+  Requires bash (process substitution).

package/jobs/travel/flight-checkin-reminder.yaml

@@ -0,0 +1,31 @@
+id: flight-checkin-reminder
+version: 1
+name: Flight Check-in Reminder
+description: >
+  Reminds you when online check-in opens for an upcoming flight. Use
+  this if you've ever missed the good seats because check-in opened
+  while you were asleep.
+category: travel
+tags: [travel, flight, reminder]
+schedule: "0 * * * *"
+timezone: "UTC"
+runner: shell
+command: >
+  flight="{{flight_datetime}}"; hours_before={{checkin_hours_before}};
+  flight_epoch=$(date -j -f "%Y-%m-%d %H:%M" "$flight" +%s 2>/dev/null || date -d "$flight" +%s);
+  now_epoch=$(date +%s);
+  hours_left=$(( (flight_epoch-now_epoch)/3600 ));
+  if [ "$hours_left" -le 0 ]; then echo "note: flight time has passed — update flight_datetime for your next trip.";
+  elif [ "$hours_left" -le "$hours_before" ]; then echo "REMINDER: check in for your flight — departs in ${hours_left}h ($flight).";
+  else echo "OK: ${hours_left}h until flight ($flight), check-in opens around ${hours_before}h before departure."; fi
+variables:
+  flight_datetime:
+    default: "2026-12-31 08:00"
+    description: Flight departure date and time ("YYYY-MM-DD HH:MM", local to the schedule's timezone).
+  checkin_hours_before:
+    default: 24
+    description: How many hours before departure check-in typically opens for your airline.
+compatible_agents: [generic, claude, codex]
+notes: >
+  Zero-token. Runs hourly since it's a time-sensitive window — update
+  flight_datetime for each new trip.

package/jobs/travel/passport-expiry-check.yaml

@@ -0,0 +1,31 @@
+id: passport-expiry-check
+version: 1
+name: Passport Expiry Check
+description: >
+  Warns you before your passport expires — including the "6 months
+  validity required" rule many countries enforce at the border. Use
+  this if you've ever booked a trip and only checked your passport
+  date after buying the ticket.
+category: travel
+tags: [travel, passport, documents]
+schedule: "0 9 1 * *"
+timezone: "UTC"
+runner: shell
+command: >
+  expiry={{passport_expiry_date}}; warn_months={{warn_months}};
+  expiry_epoch=$(date -j -f %Y-%m-%d "$expiry" +%s 2>/dev/null || date -d "$expiry" +%s);
+  today_epoch=$(date +%s);
+  days_left=$(( (expiry_epoch-today_epoch)/86400 ));
+  warn_days=$(( warn_months * 30 ));
+  if [ "$days_left" -le 0 ]; then echo "EXPIRED: passport expired on $expiry — renew immediately."; exit 1;
+  elif [ "$days_left" -le "$warn_days" ]; then echo "WARNING: passport expires in $days_left day(s) ($expiry) — many countries require ${warn_months} month(s) of remaining validity to enter."; exit 1;
+  else echo "OK: passport valid, $days_left day(s) until expiry ($expiry)."; fi
+variables:
+  passport_expiry_date:
+    default: "2030-01-01"
+    description: Date (YYYY-MM-DD) your passport expires.
+  warn_months:
+    default: 6
+    description: Start warning this many months before expiry (6 is the common border-entry rule).
+compatible_agents: [generic, claude, codex]
+notes: Zero-token. Update passport_expiry_date after renewal.

package/jobs/travel/visa-expiry-check.yaml

@@ -0,0 +1,32 @@
+id: visa-expiry-check
+version: 1
+name: Visa/Residency Document Expiry Check
+description: >
+  Warns you before a visa, residency permit, or similar document
+  expires. Use this if you're living or working abroad and a document
+  deadline has ever crept up on you.
+category: travel
+tags: [travel, visa, documents]
+schedule: "0 9 1 * *"
+timezone: "UTC"
+runner: shell
+command: >
+  name="{{doc_name}}"; expiry={{expiry_date}}; warn={{warn_days}};
+  expiry_epoch=$(date -j -f %Y-%m-%d "$expiry" +%s 2>/dev/null || date -d "$expiry" +%s);
+  today_epoch=$(date +%s);
+  days_left=$(( (expiry_epoch-today_epoch)/86400 ));
+  if [ "$days_left" -le 0 ]; then echo "EXPIRED: $name expired on $expiry."; exit 1;
+  elif [ "$days_left" -le "$warn" ]; then echo "WARNING: $name expires in $days_left day(s) ($expiry)."; exit 1;
+  else echo "OK: $name valid, $days_left day(s) until expiry."; fi
+variables:
+  doc_name:
+    default: "visa"
+    description: What document this is (visa, residency permit, work permit, etc).
+  expiry_date:
+    default: "2027-01-01"
+    description: Date (YYYY-MM-DD) the document expires.
+  warn_days:
+    default: 30
+    description: Start warning this many days before expiry.
+compatible_agents: [generic, claude, codex]
+notes: Zero-token. One job per document — copy it and adjust for each document you're tracking.

package/package.json

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