feat: update cron handling for decay and content jobs

Author: kronosapiens

backend/.env.example

@@ -16,7 +16,10 @@ FELT_ROLE_ID=your_felt_role_id
 # Database (PostgreSQL connection string)
 DATABASE_URL=postgres://user:password@localhost:5432/daimyo
 
-# Reputation Thresholds
+# Decay Check
+# Cron schedule (optional - if not set, job won't run automatically)
+# Example: 1st of month at midnight UTC
+DECAY_CHECK_CRON=0 0 1 * *
 DECAY_WINDOW_DAYS=360
 SENPAI_REACTION_THRESHOLD=50
 SENPAI_UNIQUE_PERCENT=0.10
@@ -27,13 +30,14 @@ SENSEI_UNIQUE_PERCENT=0.20
 OHAYO_CHANNEL_ID=your_ohayo_channel_id
 
 # Content Pipeline Configuration
+# Cron schedule (optional - if not set, job won't run automatically)
+# Example: Sunday midnight UTC
+CONTENT_PIPELINE_CRON=0 0 * * 0
 # How many days back to scan for messages
 CONTENT_PIPELINE_DAYS_BACK=7
 # Target number of stories per run
 CONTENT_PIPELINE_MIN_STORIES=3
 CONTENT_PIPELINE_MAX_STORIES=10
-# Cron schedule (default: Sunday 9am UTC)
-CONTENT_PIPELINE_CRON=0 9 * * 0
 
 # AI Configuration
 LLM_MODEL=claude-sonnet-4-20250514

backend/src/jobs/contentPipeline.ts

@@ -154,10 +154,15 @@ async function runContentPipeline(client: Client, dryRun = false): Promise<void>
 
 /**
  * Schedule and start the content pipeline cron job
- * Default: Runs weekly on Sunday at 09:00 UTC
  */
 export function startContentPipelineJob(client: Client): void {
   const cronSchedule = config.contentPipelineCron;
+
+  if (!cronSchedule) {
+    console.log('⏰ Content pipeline not scheduled (CONTENT_PIPELINE_CRON not set)');
+    return;
+  }
+
   console.log(`⏰ Scheduling content pipeline: ${cronSchedule}`);
 
   cron.schedule(cronSchedule, () => {

backend/src/jobs/decayCheck.ts

@@ -58,22 +58,18 @@ async function runDecayCheck(client: Client): Promise<void> {
 
 /**
  * Schedule and start the decay check cron job
- * Runs monthly at 12:00 UTC on the 1st (0 12 1 * *)
- * Set DECAY_CHECK_ENABLED=true to enable
  */
 export function startDecayCheckJob(client: Client): void {
-  const enabled = process.env.DECAY_CHECK_ENABLED === 'true';
+  const cronSchedule = config.decayCheckCron;
 
-  if (!enabled) {
-    console.log('⏰ Decay check job disabled (set DECAY_CHECK_ENABLED=true to enable)');
+  if (!cronSchedule) {
+    console.log('⏰ Decay check not scheduled (DECAY_CHECK_CRON not set)');
     return;
   }
 
-  console.log('⏰ Scheduling monthly decay check for 12:00 UTC on the 1st (0 12 1 * *)');
+  console.log(`⏰ Scheduling decay check: ${cronSchedule}`);
 
-  // Schedule: minute hour day month dayOfWeek
-  // 0 12 1 * * = 12:00 UTC on the 1st of every month
-  cron.schedule('0 12 1 * *', () => {
+  cron.schedule(cronSchedule, () => {
     runDecayCheck(client);
   });
 

backend/src/types.ts

@@ -59,7 +59,8 @@ export interface Config {
   // Database
   databaseUrl: string;
 
-  // Thresholds
+  // Decay
+  decayCheckCron: string;
   decayWindowDays: number;
   senpaiReactionThreshold: number;
   senpaiUniquePercent: number;

backend/src/utils/config.ts

@@ -63,7 +63,8 @@ export function loadConfig(): Config {
     // Database
     databaseUrl: getRequiredEnv('DATABASE_URL'),
 
-    // Thresholds
+    // Decay
+    decayCheckCron: process.env.DECAY_CHECK_CRON || '',
     decayWindowDays: getNumberEnv('DECAY_WINDOW_DAYS', 360),
     senpaiReactionThreshold: getNumberEnv('SENPAI_REACTION_THRESHOLD', 50),
     senpaiUniquePercent: getNumberEnv('SENPAI_UNIQUE_PERCENT', 0.1),
@@ -78,7 +79,7 @@ export function loadConfig(): Config {
     contentPipelineDaysBack: getNumberEnv('CONTENT_PIPELINE_DAYS_BACK', 7),
     contentPipelineMinStories: getNumberEnv('CONTENT_PIPELINE_MIN_STORIES', 3),
     contentPipelineMaxStories: getNumberEnv('CONTENT_PIPELINE_MAX_STORIES', 10),
-    contentPipelineCron: process.env.CONTENT_PIPELINE_CRON || '0 9 * * 0',
+    contentPipelineCron: process.env.CONTENT_PIPELINE_CRON || '',
 
     // AI Configuration
     llmModel: process.env.LLM_MODEL || 'claude-sonnet-4-20250514',

spec/CONTENT.md

@@ -70,8 +70,8 @@ CONTENT_PIPELINE_DAYS_BACK=7
 CONTENT_PIPELINE_MIN_STORIES=3
 CONTENT_PIPELINE_MAX_STORIES=10
 
-# Cron schedule (default: Sunday 9am UTC)
-CONTENT_PIPELINE_CRON=0 9 * * 0
+# Cron schedule (optional - if not set, job won't run automatically)
+CONTENT_PIPELINE_CRON=0 0 * * 0
 
 # AI (uses Claude Sonnet 4 via Anthropic)
 LLM_MODEL=claude-sonnet-4-20250514