deepseek-ai/deepseek-harness · error · Error

${binName}: user patch-layer watching requires the Cordis HM

Error message

${binName}: user patch-layer watching requires the Cordis HMR service

What it means

Error "${binName}: user patch-layer watching requires the Cordis HMR service" thrown in deepseek-ai/deepseek-harness.

Source

Thrown at packages/boot/app-boot/src/index.ts:238

   * is the whole patch list.
   */
  compose?: (userPatches: PatchOptions[]) => PatchOptions[]
}

/**
 * Watch the user patch layer through Cordis HMR and transactionally reapply it to the boot include.
 * @param ctx - settled app context containing the root Include and an active HMR service.
 * @param options - diagnostic, file, and patch-composition inputs.
 * @returns an asynchronous disposer after the exact-path watcher is ready.
 * @throws when HMR or the root Include is absent, watcher setup fails, or initial path resolution fails.
 */
export async function watchUserPatches(
  ctx: Context,
  options: UserPatchWatchOptions,
): Promise<() => Promise<void>> {
  const { binName, filename, compose = (patches: PatchOptions[]) => patches } = options
  const hmr = ctx.get('hmr')
  if (hmr === undefined) throw new Error(`${binName}: user patch-layer watching requires the Cordis HMR service`)
  const entry = bootstrapIncludes.get(ctx)
  if (entry === undefined) throw new Error(`${binName}: user patch-layer watching requires the root Include entry`)
  const register = hmr.registerConfig(filename, async () => {
    // Re-read the include's non-patch options per refresh: a writer that
    // updates the root Include's other options between refreshes (none exists
    // today) must not have them silently reverted by a user-layer reload.
    const { patches: _previousPatches, ...includeConfig } = entry.options.config as Include.Config
    const userPatches = loadOptionalPatches(binName, filename) ?? []
    const patches = compose(userPatches)
    await entry.update({
      config: {
        ...includeConfig,
        patches,
      },
    })
  })
  try {
    return await register

View on GitHub (pinned to b150a551b8)

Solutions

1. Enable the Cordis HMR service, or disable user patch-layer watching.

When it happens

Trigger: Thrown at packages/boot/app-boot/src/index.ts:238 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of deepseek-ai/deepseek-harness@b150a551b8 (2026-08-24). Data as JSON: /api/errors/1c208663b37671b1. Report an issue: GitHub.