{"record":{"id":"1d61e9d9ce7f3817","repo":"Yeachan-Heo/oh-my-codex","slug":"cooldown-ms-must-be-a-non-negative-number","errorCode":null,"errorMessage":"`cooldown_ms` must be a non-negative number","messagePattern":"`cooldown_ms` must be a non-negative number","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"src/cli/tmux-hook.ts","lineNumber":137,"sourceCode":"    throw new Error('`target` is required');\n  }\n  const targetObj = target as Record<string, unknown>;\n  if (targetObj.type !== 'session' && targetObj.type !== 'pane') {\n    throw new Error('`target.type` must be \"session\" or \"pane\"');\n  }\n  if (typeof targetObj.value !== 'string' || targetObj.value.trim() === '') {\n    throw new Error('`target.value` must be a non-empty string');\n  }\n\n  const allowedModes = parsed.allowed_modes;\n  if (!Array.isArray(allowedModes) || allowedModes.length === 0 || allowedModes.some(v => typeof v !== 'string')) {\n    throw new Error('`allowed_modes` must be a non-empty string array');\n  }\n\n  const cooldown = parsed.cooldown_ms;\n  const maxInjections = parsed.max_injections_per_session;\n  if (typeof cooldown !== 'number' || cooldown < 0 || !Number.isFinite(cooldown)) {\n    throw new Error('`cooldown_ms` must be a non-negative number');\n  }\n  if (typeof maxInjections !== 'number' || maxInjections < 1 || !Number.isFinite(maxInjections)) {\n    throw new Error('`max_injections_per_session` must be >= 1');\n  }\n\n  const promptTemplate = parsed.prompt_template;\n  const marker = parsed.marker;\n  if (typeof promptTemplate !== 'string' || promptTemplate.trim() === '') {\n    throw new Error('`prompt_template` must be a non-empty string');\n  }\n  if (typeof marker !== 'string' || marker.trim() === '') {\n    throw new Error('`marker` must be a non-empty string');\n  }\n\n  if (parsed.dry_run !== true && parsed.dry_run !== false) {\n    throw new Error('`dry_run` must be boolean');\n  }\n  if (parsed.log_level !== 'error' && parsed.log_level !== 'info' && parsed.log_level !== 'debug') {","sourceCodeStart":119,"sourceCodeEnd":155,"githubUrl":"https://github.com/Yeachan-Heo/oh-my-codex/blob/3ad79a8a6fe6e95fdbb8c00e40716fffe4011ce2/src/cli/tmux-hook.ts#L119-L155","documentation":"The config's cooldown_ms field must be a number that is finite and >= 0 (throttle between hook injections). NaN, Infinity, negatives, strings, or missing values fail.","triggerScenarios":"\"cooldown_ms\": -100, \"cooldown_ms\": \"1000\", omitted key (undefined), or a computed value producing NaN.","commonSituations":"String numbers from env-var templating; zero-default assumptions; arithmetic on user input producing NaN.","solutions":["Set a non-negative finite number, e.g. \"cooldown_ms\": 1000","Coerce with Number(...) and validate before writing templated configs","Use 0 if you want no cooldown"],"exampleFix":"// before\n{\"cooldown_ms\": \"1000\"}\n// after\n{\"cooldown_ms\": 1000}","handlingStrategy":"validation","validationCode":"const c = cfg.cooldown_ms;\nif (typeof c !== 'number' || c < 0 || !Number.isFinite(c)) throw new Error('bad cooldown_ms');","typeGuard":"const isNonNegativeFinite = (v: unknown): v is number => typeof v === 'number' && v >= 0 && Number.isFinite(v);","tryCatchPattern":"try { await loadConfig(); } catch (e) { if (e instanceof Error && e.message.includes('cooldown_ms')) fixCooldown(); }","preventionTips":["Write numbers unquoted in JSON","Coerce env-var strings with Number() and validate before templating"],"tags":["config","validation","numeric","tmux-hook"],"backgroundTag":"config-schema-validation-failed","analyzedSha":"3ad79a8a6fe6e95fdbb8c00e40716fffe4011ce2","analyzedAt":"2026-08-27T22:18:39.783Z","schemaVersion":2},"datasetVersion":"2026-08-28T00:17:15.603Z"}