{"record":{"id":"fe4283ef8054525a","repo":"deepseek-ai/deepseek-harness","slug":"terminal-bash-handoffgracems-must-be-at-least-pol","errorCode":null,"errorMessage":"terminal-bash: handoffGraceMs must be at least pollIntervalMs so one readiness poll runs inside the grace window","messagePattern":"terminal-bash: handoffGraceMs must be at least pollIntervalMs so one readiness poll runs inside the grace window","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/terminal/terminal-bash/src/config.ts","lineNumber":120,"sourceCode":"/**\n * Assert every effective numeric config field is a positive safe integer and bounds compose.\n * @param config - Schemastery-resolved plugin configuration.\n * @returns Narrows the input to the fully resolved configuration.\n */\nexport function validateConfig(config: Config): asserts config is ResolvedConfig {\n  const resolved = config as ResolvedConfig\n  if (resolved.backendType.length === 0) throw new Error('terminal-bash: backendType must be non-empty')\n  if (resolved.shellPath.length === 0) throw new Error('terminal-bash: shellPath must be non-empty')\n  for (const [name, value] of Object.entries(resolved)) {\n    if (typeof value === 'number' && (!Number.isSafeInteger(value) || value <= 0)) {\n      throw new Error(`terminal-bash: ${name} must be a positive safe integer`)\n    }\n  }\n  if (resolved.maxReadBytes > resolved.scrollbackMaxBytes) {\n    throw new Error('terminal-bash: maxReadBytes must not exceed scrollbackMaxBytes')\n  }\n  if (resolved.handoffGraceMs < resolved.pollIntervalMs) {\n    throw new Error('terminal-bash: handoffGraceMs must be at least pollIntervalMs so one readiness poll runs inside the grace window')\n  }\n}\n","sourceCodeStart":102,"sourceCodeEnd":123,"githubUrl":"https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/packages/terminal/terminal-bash/src/config.ts#L102-L123","documentation":"Error \"terminal-bash: handoffGraceMs must be at least pollIntervalMs so one readiness poll runs inside the grace window\" thrown in deepseek-ai/deepseek-harness.","triggerScenarios":"Thrown at packages/terminal/terminal-bash/src/config.ts:120 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set handoffGraceMs to at least pollIntervalMs."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"b150a551b8d465e31e418e1b2eaf5e79bbb7d28e","analyzedAt":"2026-08-24T18:12:29.105Z","schemaVersion":2},"datasetVersion":"2026-08-24T22:17:12.610Z"}