Function handle

src/tools/get-codebase-health.ts:30–112

(
  args: Record<string, unknown>,
  ctx: ToolContext
)

};

export async function handle(
  args: Record<string, unknown>,
  ctx: ToolContext
): Promise<ToolResponse> {
  const file = typeof args.file === 'string' ? args.file.trim() : undefined;
  const limit = typeof args.limit === 'number' && Number.isFinite(args.limit) ? args.limit : 10;
  const level =
    args.level === 'low' || args.level === 'medium' || args.level === 'high'
      ? args.level
      : undefined;

  const health = await readHealthFile(ctx.paths.health);
  if (!health) {
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(
            {
              status: 'no_data',
              message:
                'No codebase health artifact found. Run refresh_index to generate health.json.'
            },
            null,
            2
          )
        }
      ]
    };
  }

  const orderedLevels = { high: 3, medium: 2, low: 1 };
  const minLevel = level ? orderedLevels[level] : 1;

  if (file) {
    const byFile = indexHealthByFile(health, ctx.rootPath);
    const fileHealth = byFile.get(normalizeHealthLookupKey(file, ctx.rootPath));
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(
            fileHealth
              ? {
                  status: 'success',
                  generatedAt: health.generatedAt,
                  file: fileHealth
                }
              : {
                  status: 'not_found',
                  message: `No health record found for ${file}.`,
                  generatedAt: health.generatedAt
                },
            null,
            2
          )
        }
      ]