feat: add markdown-based prompts support with auto-discovery tool (#5)

* feat: add markdown-based prompts support

- Add markdown prompt loader with frontmatter parsing using gray-matter
- Add 3 TimescaleDB-focused prompts: hypertable analysis, migration, and setup
- Update build process to copy .md files to dist directory
- Integrate with updated boilerplate supporting prompts capability
- Remove unused handlebars dependency

Prompts included:
- identifyHypertableCandidates: Analyze tables for hypertable conversion
- postgresHypertableMigration: Guide for migrating to hypertables
- timescaledbSetup: Complete TimescaleDB setup with compression and policies

* feat: add getPromptContent tool for auto-discovery

- Add MCP tool that dynamically discovers all available prompts
- Tool description includes comprehensive list of all prompts with descriptions
- Auto-generates enum of available prompts from markdown frontmatter
- Enables LLM auto-discovery of TimescaleDB guidance prompts
- Updated timescaledb setup prompt description to be more comprehensive

Benefits:
- LLM can automatically choose appropriate prompts based on user needs
- No need for users to explicitly know prompt names
- Stays in sync as new .md files are added

* refactor: rename tool from getPromptContent to getGuide

- Rename tool name to be more user-friendly and intuitive
- Update file name from getPromptContent.ts to getGuide.ts
- Clean up tool description by removing redundant text
- Update section header from 'Available Prompts' to 'Available Guides'

* refactor: simplify prompts architecture by removing factory pattern

- Replace factory-based approach with simple Map-based prompts loading
- Convert promptFactories to direct prompts Map with {name, title, description, content} structure
- Update getGuide tool to use prompts Map directly for O(1) lookup
- Simplify mcpServer and stdio to accept prompts Map instead of factories
- Remove PromptFactory, PromptDefinition, PromptConfig types from boilerplate
- Delete markdownLoader.ts and unused factory complexity
- Rename markdown files to camelCase naming convention
- Remove name field from frontmatter to establish single source of truth
- Both MCP prompts and getGuide tool now use same simple data source
- Fix YAML parsing by properly quoting description field

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* chore: update boilerplate submodule to latest main

- Update boilerplate submodule to point to latest main with prompts support
- Maintain adapter pattern in stdio.ts to convert prompts Map to promptFactories
- Everything working correctly with both MCP prompts and getGuide tool

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: cevian

package-lock.json

@@ -13,7 +13,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc && shx chmod +x dist/*.js",
+    "build": "tsc && shx cp -r src/prompts/md dist/prompts/ && shx chmod +x dist/*.js",
     "prepare": "npm run build",
     "watch": "tsc --watch",
     "watch:http": "tsx watch src/index.ts http",
@@ -39,6 +39,7 @@
     "ai": "^5.0.17",
     "dotenv": "^17.2.0",
     "express": "^5.1.0",
+    "gray-matter": "^4.0.3",
     "pg": "^8.16.3",
     "zod": "^3.23.8"
   },

package.json

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { ApiFactory } from '../shared/boilerplate/src/types.js';
+import { ServerContext } from '../types.js';
+import { prompts } from '../prompts/index.js';
+
+// Create enum schema dynamically
+const inputSchema = {
+  prompt_name: z
+    .enum(Array.from(prompts.keys()) as [string, ...string[]])
+    .describe('The name of the prompt to retrieve'),
+} as const;
+
+const outputSchema = {
+  prompt_name: z.string().describe('The name of the requested prompt'),
+  title: z.string().describe('The display title of the prompt'),
+  description: z.string().describe('Description of what this prompt does'),
+  content: z.string().describe('The full prompt content'),
+} as const;
+
+export const getPromptContentFactory: ApiFactory<
+  ServerContext,
+  typeof inputSchema,
+  typeof outputSchema
+> = () => ({
+  name: 'getGuide',
+  config: {
+    title: 'Get TimescaleDB Guide',
+    description: `Retrieve detailed TimescaleDB guides and best practices.
+
+Available Guides:
+
+${Array.from(prompts.values()).map(p => `**${p.name}** - ${p.description}`).join('\n\n')}
+`,
+    inputSchema,
+    outputSchema,
+  },
+  fn: async ({ prompt_name }) => {
+    const prompt = prompts.get(prompt_name);
+
+    if (!prompt) {
+      throw new Error(`Prompt '${prompt_name}' not found`);
+    }
+
+    return {
+      prompt_name: prompt.name,
+      title: prompt.title || prompt.name,
+      description: prompt.description || '',
+      content: prompt.content,
+    };
+  },
+});

src/apis/getGuide.ts

@@ -1,7 +1,9 @@
 import { semanticSearchPostgresDocsFactory } from './semanticSearchPostgresDocs.js';
 import { semanticSearchTimescaleDocsFactory } from './semanticSearchTimescaleDocs.js';
+import { getPromptContentFactory } from './getGuide.js';
 
 export const apiFactories = [
   semanticSearchPostgresDocsFactory,
   semanticSearchTimescaleDocsFactory,
+  getPromptContentFactory,
 ] as const;

src/apis/index.ts

@@ -0,0 +1,31 @@
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { readdirSync, readFileSync } from 'fs';
+import matter from 'gray-matter';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const markdownPromptsDir = join(__dirname, 'md');
+
+// Load all markdown prompts with their metadata
+function loadPrompts() {
+  const files = readdirSync(markdownPromptsDir).filter(file => file.endsWith('.md'));
+  const promptsMap = new Map();
+  
+  for (const file of files) {
+    const promptName = file.replace('.md', '');
+    const filePath = join(markdownPromptsDir, file);
+    const fileContent = readFileSync(filePath, 'utf-8');
+    const { data, content } = matter(fileContent);
+    
+    promptsMap.set(promptName, {
+      name: promptName,
+      title: data.title,
+      description: data.description,
+      content: content.trim(),
+    });
+  }
+  
+  return promptsMap;
+}
+
+export const prompts = loadPrompts();