mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-09-30 12:39:42 +02:00
KrisandClaude Opus 4.8
6ae86b53f6
Adds a saved/named scheduling layer on top of Codeman's existing session primitives. Distinct from the legacy run-now ScheduledRun concept. - types/scheduler.ts: ScheduledJob + ScheduledJobRun - state-store: persist scheduledJobs/scheduledJobRuns in ~/.codeman/state.json - scheduler/scheduler-time.ts: pure once/interval/daily/weekly next-run math - scheduler/scheduler-service.ts: CRUD, Run Now, due-checker tick, run history; reuses SessionPort (create -> start -> writeViaMux) for launches - web/routes/scheduler-routes.ts: /api/scheduler/jobs CRUD + run + history - web/schemas.ts: zod validation with schedule-type-aware refinements - web/sse-events.ts: scheduler:* events - server.ts: wire service into route context + 30s background tick loop - test/scheduler-time.test.ts: 14 unit tests for next-run calculations Phase 1 discovery recorded in SCHEDULER_DISCOVERY.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Rp7JhmQXcYJhmxFMdZuuah
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;
|
||
|
||
// ============================================================================
|
||
// Scheduled Jobs (cron-style scheduler)
|
||
// ============================================================================
|
||
|
||
/** How often the scheduler loop wakes to check for due jobs (ms). */
|
||
export const SCHEDULER_TICK_INTERVAL = 30 * 1000;
|
||
|
||
/** Max attempts (× 500ms) to poll a launched session for CLI readiness before sending the prompt. */
|
||
export const SCHEDULER_READY_MAX_ATTEMPTS = 60;
|
||
|
||
/** Extra settle delay after CLI readiness is detected, before sending the prompt (ms). */
|
||
export const SCHEDULER_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;
|