{"record":{"id":"99ef9b8371222a49","repo":"deepseek-ai/deepseek-harness","slug":"binname-label-file-must-be-a-top-level-y","errorCode":null,"errorMessage":"${binName}: ${label} ${file} must be a top-level YAML array of loader patch entries","messagePattern":"(.+?): (.+?) (.+?) must be a top-level YAML array of loader patch entries","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/boot/app-boot/src/index.ts","lineNumber":330,"sourceCode":" * single patch whose target row is absent stays a per-entry Loader warning, so\n * one overlay shared across surfaces does not have to match every tree.\n * @param binName - the diagnostic prefix on the thrown error.\n * @param file - the source path, quoted in errors.\n * @param content - the file's text.\n * @param label - what to call this list in errors (`patches`, `overlay`).\n * @returns the parsed patch list.\n */\nfunction parsePatchList(\n  binName: string, file: string, content: string, label: string,\n): PatchOptions[] {\n  let parsed: unknown\n  try {\n    parsed = yaml.load(content, { schema: userPatchesSchema })\n  } catch (error) {\n    throw new Error(`${binName}: failed to parse ${label} ${file}: ${String(error)}`)\n  }\n  if (!Array.isArray(parsed)) {\n    throw new Error(`${binName}: ${label} ${file} must be a top-level YAML array of loader patch entries`)\n  }\n  parsed.forEach((entry, index) => {\n    if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) {\n      throw new Error(`${binName}: ${label} entry ${index + 1} in ${file} must be a mapping (a loader patch entry)`)\n    }\n  })\n  return parsed as PatchOptions[]\n}\n\n/** One overlay patch list with the source label printed in dump comments. */\nexport interface ConfigDumpLayer {\n  /** Source name shown in dump comments (a file basename or path). */\n  label: string\n  /** The layer's patches, from {@link loadOverlayPatches} / {@link loadOptionalPatches}. */\n  patches: PatchOptions[]\n}\n\n/**","sourceCodeStart":312,"sourceCodeEnd":348,"githubUrl":"https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/packages/boot/app-boot/src/index.ts#L312-L348","documentation":"Error \"${binName}: ${label} ${file} must be a top-level YAML array of loader patch entries\" thrown in deepseek-ai/deepseek-harness.","triggerScenarios":"Thrown at packages/boot/app-boot/src/index.ts:330 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Make the YAML document a top-level array of loader patch entries."],"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"}