abhigyanpatwari/GitNexus · error

GitNexus: non-ASCII path "${p}" could not be converted to an

Error message

GitNexus: non-ASCII path "${p}" could not be converted to an ASCII-safe form. LadybugDB may fail with "Cannot open file." To fix: move the repo to a path without CJK/Unicode characters, or enable 8.3 short names on this volume (fsutil 8dot3name set 0).

What it means

Error "GitNexus: non-ASCII path "${p}" could not be converted to an ASCII-safe form. LadybugDB may fail with "Cannot open file." To fix: move the repo to a path without CJK/Unicode characters, or enable 8.3 short names on this volume (fsutil 8dot3name set 0)." thrown in abhigyanpatwari/GitNexus.

Source

Thrown at gitnexus/src/core/lbug/lbug-config.ts:183

  const shortPath = tryShortPath(p);
  if (shortPath) return shortPath;

  if (!isMainThread) {
    logger.warn(
      `GitNexus: non-ASCII path in worker thread — junction fallback skipped. ` +
        `Path: "${p}". 8.3 short names may need to be enabled on this volume.`,
    );
    return p;
  }

  const targetDir = path.dirname(p);
  const leaf = path.basename(p);
  if (fsSync.existsSync(targetDir)) {
    const junctionResult = tryJunction(targetDir, leaf);
    if (junctionResult) return junctionResult;
  }

  logger.warn(
    `GitNexus: non-ASCII path "${p}" could not be converted to an ASCII-safe form. ` +
      'LadybugDB may fail with "Cannot open file." To fix: move the repo to a path ' +
      'without CJK/Unicode characters, or enable 8.3 short names on this volume ' +
      '(fsutil 8dot3name set 0).',
  );
  return p;
}

/**
 * Resolve the on-disk CSV staging dir for `<storagePath>/<subdir>`, applying the
 * same ASCII-safe relocation `toNativeSafePath` enables: on Windows with a
 * non-ASCII storage path, LadybugDB's bulk COPY cannot open files under that
 * path, so the dir is relocated under `os.tmpdir()`. Shared by the structural
 * `csv/` dir and the streaming `pdg-csv/` dir (#2202) so the two can never
 * diverge on platform handling; the `gitnexus-<subdir>-` prefix keeps their tmp
 * locations distinct and recognizable.
 *
 * The relocated dir is created with `fs.mkdtempSync` (a unique, mode-0700,

View on GitHub (pinned to aac7515d2a)

When it happens

Trigger: Thrown at gitnexus/src/core/lbug/lbug-config.ts:183 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of abhigyanpatwari/GitNexus@aac7515d2a (2026-08-20). Data as JSON: /api/errors/a9287889a1449bfb. Report an issue: GitHub.