Function loadCustomCommands

src/cli/custom-commands.ts:69–104

(cwd: string)

/** Inspect both discovery dirs and return the merged command map. Project wins on collisions. */
export async function loadCustomCommands(cwd: string): Promise<Map<string, CustomCommandSpec>> {
  const map = new Map<string, CustomCommandSpec>();
  // Claude Code commands first (lowest precedence) so a user's own QodeX command of
  // the same name wins (later entries overwrite earlier ones in the map).
  const claudeDirs = (await claudeCodeCommandDirs(cwd)).map(d => ({ dir: d.dir, origin: 'plugin' as const }));
  const dirs: Array<{ dir: string; origin: 'project' | 'user' | 'plugin' }> = [
    ...claudeDirs,
    { dir: path.join(os.homedir(), '.qodex', 'commands'), origin: 'user' },
    { dir: path.join(cwd, '.qodex', 'commands'), origin: 'project' },
  ];
  for (const { dir, origin } of dirs) {
    let entries;
    try {
      entries = await fs.readdir(dir, { withFileTypes: true });
    } catch {
      continue;
    }
    for (const ent of entries) {
      if (!ent.isFile() || !ent.name.endsWith('.md')) continue;
      const name = ent.name.slice(0, -3);
      if (!/^[a-zA-Z][\w-]*$/.test(name)) {
        logger.debug('Skipping custom command with invalid name', { file: ent.name });
        continue;
      }
      const filePath = path.join(dir, ent.name);
      try {
        const raw = await fs.readFile(filePath, 'utf-8');
        const spec = parseSpec(raw, name, filePath, origin);
        map.set(name, spec);
      } catch (e: any) {
        logger.warn('Failed to load custom command', { file: filePath, err: e.message });
      }
    }
  }
  return map;
}

/** Parse a Markdown file into a CustomCommandSpec. */
export function parseSpec(