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

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,11 @@
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { loadMarkdownPromptsFromDirectory } from './markdownLoader.js';
+import { ServerContext } from '../types.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const markdownPromptsDir = join(__dirname, 'md');
+
+export const promptFactories = [
+  ...loadMarkdownPromptsFromDirectory<ServerContext>(markdownPromptsDir),
+] as const;

src/prompts/index.ts

@@ -0,0 +1,73 @@
+import { readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+import matter from 'gray-matter';
+import { z } from 'zod';
+import { PromptFactory } from '../shared/boilerplate/src/types.js';
+
+const PromptArgumentSchema = z.object({
+  name: z.string(),
+  description: z.string().optional(),
+  required: z.boolean().optional().default(false),
+});
+
+const PromptFrontmatterSchema = z.object({
+  name: z.string(),
+  title: z.string().optional(),
+  description: z.string().optional(),
+  arguments: z.array(PromptArgumentSchema).optional().default([]),
+});
+
+export const loadMarkdownPrompt = <Context extends Record<string, unknown>>(
+  filePath: string,
+): PromptFactory<Context, any> => {
+  const fileContent = readFileSync(filePath, 'utf-8');
+  const { data, content } = matter(fileContent);
+  
+  const frontmatter = PromptFrontmatterSchema.parse(data);
+  
+  // Create zod schema from arguments
+  const inputSchemaShape: Record<string, z.ZodTypeAny> = {};
+  for (const arg of frontmatter.arguments) {
+    let schema: z.ZodTypeAny = z.string();
+    if (arg.description) {
+      schema = schema.describe(arg.description);
+    }
+    if (!arg.required) {
+      schema = schema.optional();
+    }
+    inputSchemaShape[arg.name] = schema;
+  }
+
+  return () => ({
+    name: frontmatter.name,
+    config: {
+      title: frontmatter.title,
+      description: frontmatter.description,
+      inputSchema: inputSchemaShape,
+    },
+    fn: async (args) => {
+      return {
+        description: frontmatter.description || frontmatter.title || frontmatter.name,
+        messages: [
+          {
+            role: 'user',
+            content: {
+              type: 'text',
+              text: content.trim(),
+            },
+          },
+        ],
+      };
+    },
+  });
+};
+
+export const loadMarkdownPromptsFromDirectory = <Context extends Record<string, unknown>>(
+  dirPath: string,
+): PromptFactory<Context, any>[] => {
+  const files = readdirSync(dirPath).filter((file: string) => file.endsWith('.md'));
+  
+  return files.map((file: string) => 
+    loadMarkdownPrompt<Context>(join(dirPath, file))
+  );
+};