mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-10-02 13:39:41 +02:00
KrisandClaude Opus 4.8
9feaa0d6e5
Rename the recurring-jobs feature scheduler->cron to disambiguate from the legacy ScheduledRun system (/api/scheduled), which is left untouched: - ScheduledJob->CronJob, SchedulerService->CronService - /api/scheduler/jobs -> /api/cron/jobs; SSE scheduler:* -> cron:* - state keys cronJobs/cronJobRuns - files moved to src/cron/, cron-routes.ts, cron-port.ts, types/cron.ts - frontend cron-ui.js, #cronModal, menu "Cron" - docs moved to docs/cron-discovery.md + docs/cron-build-brief.md, README guides - new tests: cron-service.test.ts, cron-time.test.ts Green: tsc, lint, frontend-syntax, format, 30 cron + 9 legacy scheduled-runs tests. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PmvZR12aX2v8K7YhqxPUAU
102 lines
4.1 KiB
TypeScript
102 lines
4.1 KiB
TypeScript
/**
|
||
* @fileoverview Web server performance and scheduling constants.
|
||
*
|
||
* Controls terminal batching throughput, SSE health checking,
|
||
* state persistence debouncing, and scheduled run timing.
|
||
*
|
||
* @module config/server-timing
|
||
*/
|
||
|
||
// ============================================================================
|
||
// Terminal & SSE Performance
|
||
// ============================================================================
|
||
|
||
/** Terminal data batching interval — targets 60fps (ms) */
|
||
export const TERMINAL_BATCH_INTERVAL = 16;
|
||
|
||
/** Immediate flush threshold for terminal batches (bytes).
|
||
* Set high (32KB) to allow effective batching; avg Ink events are ~14KB. */
|
||
export const BATCH_FLUSH_THRESHOLD = 32 * 1024;
|
||
|
||
/** Task event batching interval (ms) */
|
||
export const TASK_UPDATE_BATCH_INTERVAL = 100;
|
||
|
||
/** SSE heartbeat interval — sends padded keepalive to flush proxy buffers (ms).
|
||
* 15s is fast enough to keep Cloudflare tunnel buffers flushed while avoiding
|
||
* excessive bandwidth. Also serves as dead-client detection. */
|
||
export const SSE_HEARTBEAT_INTERVAL = 15 * 1000;
|
||
|
||
/** SSE padding size (bytes). Cloudflare quick tunnels buffer small SSE events;
|
||
* appending ~8KB of SSE comment padding forces the proxy to flush immediately.
|
||
* SSE comments (lines starting with ':') are silently ignored by EventSource. */
|
||
export const SSE_PADDING_SIZE = 8 * 1024;
|
||
|
||
// ============================================================================
|
||
// State Persistence
|
||
// ============================================================================
|
||
|
||
/** State update debounce — batches expensive toDetailedState() calls (ms) */
|
||
export const STATE_UPDATE_DEBOUNCE_INTERVAL = 500;
|
||
|
||
/** Sessions list cache TTL — avoids re-serializing on every SSE init (ms) */
|
||
export const SESSIONS_LIST_CACHE_TTL = 1000;
|
||
|
||
// ============================================================================
|
||
// Scheduled Runs
|
||
// ============================================================================
|
||
|
||
/** Scheduled runs cleanup check interval (ms) */
|
||
export const SCHEDULED_CLEANUP_INTERVAL = 5 * 60 * 1000;
|
||
|
||
/** Completed scheduled run max age before cleanup (ms) */
|
||
export const SCHEDULED_RUN_MAX_AGE = 60 * 60 * 1000;
|
||
|
||
// ============================================================================
|
||
// Cron Jobs
|
||
// ============================================================================
|
||
|
||
/** How often the cron loop wakes to check for due jobs (ms). */
|
||
export const CRON_TICK_INTERVAL = 30 * 1000;
|
||
|
||
/** Max attempts (× 500ms) to poll a launched session for CLI readiness before sending the prompt. */
|
||
export const CRON_READY_MAX_ATTEMPTS = 60;
|
||
|
||
/** Extra settle delay after CLI readiness is detected, before sending the prompt (ms). */
|
||
export const CRON_READY_SETTLE_MS = 2000;
|
||
|
||
/** Session limit retry wait before retrying (ms) */
|
||
export const SESSION_LIMIT_WAIT_MS = 5000;
|
||
|
||
/** Pause between scheduled run iterations (ms) */
|
||
export const ITERATION_PAUSE_MS = 2000;
|
||
|
||
// ============================================================================
|
||
// Mux Stats
|
||
// ============================================================================
|
||
|
||
/** Mux stats collection interval (ms) */
|
||
export const STATS_COLLECTION_INTERVAL_MS = 2000;
|
||
|
||
// ============================================================================
|
||
// Process Error Recovery
|
||
// ============================================================================
|
||
|
||
/** Max consecutive unhandled errors before auto-restart */
|
||
export const MAX_CONSECUTIVE_ERRORS = 5;
|
||
|
||
/** Error counter reset interval — forgives errors after quiet period (ms) */
|
||
export const ERROR_RESET_MS = 60_000;
|
||
|
||
// ============================================================================
|
||
// Common Cleanup Intervals
|
||
// ============================================================================
|
||
|
||
/** Standard 1-minute cleanup/check interval used by multiple subsystems (ms) */
|
||
export const CLEANUP_CHECK_INTERVAL_MS = 60_000;
|
||
|
||
/** Standard 1-hour max age for stale/completed data (ms) */
|
||
export const STALE_DATA_MAX_AGE_MS = 60 * 60 * 1000;
|
||
|
||
/** Standard 5-minute inactivity timeout for streams and caches (ms) */
|
||
export const INACTIVITY_TIMEOUT_MS = 5 * 60 * 1000;
|