@tigerdata/mcp-boilerplate 1.3.4 → 1.4.0

package/dist/index.d.ts

@@ -7,4 +7,4 @@ export { registerExitHandlers } from './registerExitHandlers.js';
 export { StatusError } from './StatusError.js';
 export { stdioServerFactory } from './stdio.js';
 export { addAiResultToSpan, withSpan } from './tracing.js';
-export type { ApiFactory, InferSchema, McpFeatureFlags, ParsedQs, PromptFactory, ResourceFactory, } from './types.js';
+export type { ApiFactory, InferSchema, McpFeatureFlags, MigrationsConfig, ParsedQs, PromptFactory, ResourceFactory, } from './types.js';

package/dist/migrate.js

@@ -64,16 +64,35 @@ export const createMigrator = (config) => {
     return {
         run: async () => new Promise((resolve, reject) => {
             log.info('Running database migrations...');
+            // Set search_path via PGOPTIONS so every pg.Client created by migration
+            // files picks it up automatically, without touching the migration files.
+            const prevPgOptions = process.env.PGOPTIONS;
+            if (schema) {
+                process.env.PGOPTIONS =
+                    `${prevPgOptions ?? ''} --search_path=${schema},public`.trim();
+            }
+            const restore = () => {
+                if (schema) {
+                    if (prevPgOptions === undefined) {
+                        delete process.env.PGOPTIONS;
+                    }
+                    else {
+                        process.env.PGOPTIONS = prevPgOptions;
+                    }
+                }
+            };
             migrate.load({
                 stateStore,
                 migrationsDirectory: migrationsDirectory ?? './migrations',
             }, (err, set) => {
                 if (err) {
+                    restore();
                     log.error('Database migration failed:', err);
                     stateStore.close().finally(() => reject(err));
                     return;
                 }
                 set.up((err) => {
+                    restore();
                     stateStore.close().finally(() => {
                         if (err) {
                             log.error('Database migration failed:', err);

package/dist/skills/types.d.ts

@@ -36,6 +36,7 @@ export declare const zGitHubSkillCfg: z.ZodObject<{
     type: z.ZodLiteral<"github">;
     repo: z.ZodString;
     path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type GitHubSkillCfg = z.infer<typeof zGitHubSkillCfg>;
 export declare const zGitHubCollectionSkillCfg: z.ZodObject<{
@@ -45,6 +46,7 @@ export declare const zGitHubCollectionSkillCfg: z.ZodObject<{
     type: z.ZodLiteral<"github_collection">;
     repo: z.ZodString;
     path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type GitHubCollectionSkillCfg = z.infer<typeof zGitHubCollectionSkillCfg>;
 export declare const zSkillCfg: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -60,6 +62,7 @@ export declare const zSkillCfg: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"github">;
     repo: z.ZodString;
     path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     enabled_skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
     disabled_skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -67,6 +70,7 @@ export declare const zSkillCfg: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"github_collection">;
     repo: z.ZodString;
     path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">;
 export type SkillCfg = z.infer<typeof zSkillCfg>;
 export declare const zSkillCfgMap: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -82,6 +86,7 @@ export declare const zSkillCfgMap: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
     type: z.ZodLiteral<"github">;
     repo: z.ZodString;
     path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     enabled_skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
     disabled_skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -89,6 +94,7 @@ export declare const zSkillCfgMap: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUn
     type: z.ZodLiteral<"github_collection">;
     repo: z.ZodString;
     path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">>;
 export type SkillCfgMap = z.infer<typeof zSkillCfgMap>;
 export declare const zSkillMatter: z.ZodObject<{
@@ -109,6 +115,7 @@ export declare const zGitHubSkill: z.ZodObject<{
     type: z.ZodLiteral<"github">;
     repo: z.ZodString;
     path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type GitHubSkill = z.infer<typeof zGitHubSkill>;
 export declare const zSkill: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -122,6 +129,7 @@ export declare const zSkill: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"github">;
     repo: z.ZodString;
     path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">;
 export type Skill = z.infer<typeof zSkill>;
 export declare const zSkillMap: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -135,6 +143,7 @@ export declare const zSkillMap: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion
     type: z.ZodLiteral<"github">;
     repo: z.ZodString;
     path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">>;
 export type SkillMap = z.infer<typeof zSkillMap>;
 export interface SkillsFlags {

package/dist/skills/types.js

@@ -22,11 +22,13 @@ export const zGitHubSkillCfg = z.object({
     type: z.literal('github'),
     repo: z.string(),
     path: z.string().optional(),
+    ref: z.string().optional(),
 });
 export const zGitHubCollectionSkillCfg = zCollectionFlagsCfg.extend({
     type: z.literal('github_collection'),
     repo: z.string(),
     path: z.string().optional(),
+    ref: z.string().optional(),
 });
 export const zSkillCfg = z.discriminatedUnion('type', [
     zLocalSkillCfg,

package/dist/skills/utils.js

@@ -107,7 +107,7 @@ const doLoadSkills = async (octokit) => {
             log.error(`Failed to load skill at path: ${skillPath}`, err);
         }
     };
-    const loadGitHubPath = async (owner, repo, path, flags) => {
+    const loadGitHubPath = async (owner, repo, path, ref, flags) => {
         if (shouldIgnorePath(path, flags))
             return;
         const skillPath = `${path}/SKILL.md`;
@@ -120,6 +120,7 @@ const doLoadSkills = async (octokit) => {
                 owner,
                 repo,
                 path: skillPath,
+                ...(ref ? { ref } : {}),
             });
             if (Array.isArray(skillFileResponse.data) ||
                 skillFileResponse.data.type !== 'file') {
@@ -127,6 +128,7 @@ const doLoadSkills = async (octokit) => {
                     owner,
                     repo,
                     path: skillPath,
+                    ref,
                 });
                 return;
             }
@@ -140,13 +142,14 @@ const doLoadSkills = async (octokit) => {
                 type: 'github',
                 repo: `${owner}/${repo}`,
                 path,
+                ...(ref ? { ref } : {}),
                 name,
                 description,
             });
             skillContentCache.set(`${name}/SKILL.md`, content);
         }
         catch (err) {
-            log.error(`Failed to load skill at GitHub path: ${owner}/${repo}/${skillPath}\n${err.message}`);
+            log.error(`Failed to load skill at GitHub path: ${owner}/${repo}/${skillPath}${ref ? `@${ref}` : ''}\n${err.message}`);
         }
     };
     const promises = [];
@@ -181,7 +184,7 @@ const doLoadSkills = async (octokit) => {
                         log.error(`Invalid GitHub repo format in skill config: ${cfg.repo}`, null, { name, repo: cfg.repo });
                         break;
                     }
-                    promises.push(loadGitHubPath(owner, repo, cfg.path || '.'));
+                    promises.push(loadGitHubPath(owner, repo, cfg.path || '.', cfg.ref));
                     break;
                 }
                 case 'github_collection': {
@@ -201,9 +204,10 @@ const doLoadSkills = async (octokit) => {
                         owner,
                         repo,
                         path: rootPath,
+                        ...(cfg.ref ? { ref: cfg.ref } : {}),
                     });
                     if (!Array.isArray(dirResponse.data)) {
-                        log.error(`Expected github_collection repo path to be a directory`, null, { name, owner, repo, path: cfg.path || '.' });
+                        log.error(`Expected github_collection repo path to be a directory`, null, { name, owner, repo, path: cfg.path || '.', ref: cfg.ref });
                         break;
                     }
                     const flags = parseCollectionFlags(cfg);
@@ -217,7 +221,7 @@ const doLoadSkills = async (octokit) => {
                             });
                             continue;
                         }
-                        promises.push(loadGitHubPath(owner, repo, entry.path, flags));
+                        promises.push(loadGitHubPath(owner, repo, entry.path, cfg.ref, flags));
                     }
                     break;
                 }
@@ -385,6 +389,7 @@ const getSkillContent = async ({ skill, path: targetPath, octokit, }) => {
                 owner,
                 repo,
                 path,
+                ...(skill.ref ? { ref: skill.ref } : {}),
             });
             if (Array.isArray(response.data)) {
                 // Directory listing

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tigerdata/mcp-boilerplate",
-  "version": "1.3.4",
+  "version": "1.4.0",
   "description": "MCP boilerplate code for Node.js",
   "license": "Apache-2.0",
   "author": "TigerData",