Function getProjectDirsUpToHome

src/utils/markdownConfigLoader.ts:278–335

(
  subdir: NcodeConfigDirectory,
  cwd: string,
)

 * @returns Array of directory paths containing .claude/.ncode subdirs, from most specific (cwd) to least specific
 */
export function getProjectDirsUpToHome(
  subdir: NcodeConfigDirectory,
  cwd: string,
): string[] {
  const home = resolve(homedir()).normalize('NFC')
  const gitRoot = resolveStopBoundary(cwd)
  let current = resolve(cwd)
  const dirs: string[] = []

  // Traverse from current directory up to git root (or home if not in a git repo)
  while (true) {
    // Stop if we've reached the home directory (don't check it, as it's loaded separately as userDir)
    // Use normalized comparison to handle Windows drive letter casing (C:\ vs c:\)
    if (
      normalizePathForComparison(current) === normalizePathForComparison(home)
    ) {
      break
    }

    // Filter to existing dirs. This is a perf filter (avoids spawning
    // ripgrep on non-existent dirs downstream) and the worktree fallback
    // in loadMarkdownFilesForSubdir relies on it. statSync + explicit error
    // handling instead of existsSync — re-throws unexpected errors rather
    // than silently swallowing them. Downstream loadMarkdownFiles handles
    // the TOCTOU window (dir disappearing before read) gracefully.
    for (const configDir of getExistingProjectOrManagedDirs(current, subdir)) {
      dirs.push(configDir)
    }
    // Codex-aligned cross-vendor ancestor walk: per-directory
    // `<dir>/.agents/skills` matching `repo_agents_skill_roots`. Skills-only;
    // no recursive whole-repo scan.
    if (subdir === 'skills') {
      pushIfExistingDir(dirs, join(current, '.agents', subdir))
    }

    // Stop after processing the git root directory - this prevents commands from parent
    // directories outside the repository from appearing in the project
    if (
      gitRoot &&
      normalizePathForComparison(current) ===
        normalizePathForComparison(gitRoot)
    ) {
      break
    }

    // Move to parent directory
    const parent = dirname(current)

    // Safety check: if parent is the same as current, we've reached the root
    if (parent === current) {
      break
    }

    current = parent
  }

  return dirs
}