Claude Prompts MCP Server

// @lifecycle canonical - Directory discovery and watch-target building for hot-reload setup.
import * as path from 'node:path';

import type { Logger } from '../../shared/types/index.js';

/** Minimal interface for checking YAML prompt presence in a directory. */
export interface YamlPromptChecker {
  hasYamlPrompts(dir: string): boolean;
}

export interface WatchTarget {
  path: string;
  category?: string;
}

/**
 * Discover prompt category directories suitable for file watching.
 *
 * Categories are identified by containing YAML prompt files
 * (either {id}/prompt.yaml subdirectories or {id}.yaml files).
 * Non-prompt directories are included as watch targets too
 * (they might gain prompts later).
 */
export async function discoverPromptDirectories(
  promptsDir: string,
  checker: YamlPromptChecker,
  logger: Logger
): Promise<WatchTarget[]> {
  const directories: WatchTarget[] = [];

  try {
    const fs = await import('node:fs/promises');
    const entries = await fs.readdir(promptsDir, { withFileTypes: true });

    for (const entry of entries) {
      if (
        entry.isDirectory() &&
        entry.name !== 'node_modules' &&
        entry.name !== 'backup' &&
        !entry.name.startsWith('.') &&
        !entry.name.startsWith('_')
      ) {
        const fullPath = path.join(promptsDir, entry.name);
        const hasYaml = checker.hasYamlPrompts(fullPath);

        directories.push(hasYaml ? { path: fullPath, category: entry.name } : { path: fullPath });
      }
    }
  } catch (error) {
    logger.error('Failed to discover prompt directories:', error);
  }

  return directories;
}

/**
 * Build a deduplicated map of watch targets from prompt directories,
 * methodology directories, and auxiliary reload directories.
 */
export function buildWatchTargets(
  promptsDir: string,
  categoryDirs: WatchTarget[],
  options?: {
    methodologyDirectories?: string[];
    auxiliaryDirectories?: string[][];
  }
): WatchTarget[] {
  const targets = new Map<string, WatchTarget>();

  // Main prompts directory
  targets.set(promptsDir, { path: promptsDir });

  // Category directories
  for (const dir of categoryDirs) {
    const target: WatchTarget = { path: dir.path };
    if (dir.category) {
      target.category = dir.category;
    }
    targets.set(dir.path, target);
  }

  // Methodology directories
  if (options?.methodologyDirectories) {
    for (const dir of options.methodologyDirectories) {
      if (dir) {
        targets.set(dir, { path: dir });
      }
    }
  }

  // Auxiliary reload directories
  if (options?.auxiliaryDirectories) {
    for (const dirs of options.auxiliaryDirectories) {
      for (const dir of dirs) {
        if (dir) {
          targets.set(dir, { path: dir });
        }
      }
    }
  }

  return [...targets.values()];
}