@vantageos/vantage-registry-mcp 1.4.0 → 1.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vantageos/vantage-registry-mcp",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "MCP server exposing VantageRegistry Convex functions as Claude Code tools",
   "type": "module",
   "bin": {

package/server.js

@@ -56,7 +56,7 @@ var hookEventSchema = z.enum([
   "UserPromptSubmit"
 ]).describe("Hook lifecycle event");
 var runbookStatusSchema = z.enum(["draft", "published", "deprecated"]).describe("Runbook status");
-var templateTypeSchema = z.enum(["mission", "document", "checklist"]).describe("Template type");
+var templateTypeSchema = z.enum(["standard", "mission", "brief", "runbook", "document", "checklist"]).describe("Template type");
 var linkTypeSchema = z.enum(["uses", "produces", "references"]).describe(
   "Link type \u2014 uses: template consumed during execution, produces: output document generated, references: informational cross-reference"
 );
@@ -64,7 +64,7 @@ var convexUrl = loadConvexUrl();
 var convex = new ConvexHttpClient(convexUrl);
 var server = new McpServer({
   name: "vantage-registry",
-  version: "1.4.0"
+  version: "1.5.0"
 });
 server.tool(
   "upsert_team",
@@ -770,13 +770,20 @@ server.tool(
 );
 server.tool(
   "upsert_template",
-  "Create or update a template in VantageRegistry. Upserts by name.",
+  "Create or update a template in VantageRegistry. Upserts by name. contentHash is auto-computed server-side (sha256 of content) when omitted.",
   {
     name: z.string().describe("Template name \u2014 e.g. 'agent-brief', 'skill-md'"),
     team: z.string().optional().describe("Team this template belongs to \u2014 defaults to 'global'"),
     purpose: z.string().describe("What this template is used for"),
     content: z.string().describe("Full template content"),
-    version: z.string().optional().describe("Semantic version \u2014 e.g. '1.0.0'")
+    version: z.string().optional().describe("Semantic version \u2014 e.g. '1.0.0'"),
+    template_type: templateTypeSchema.optional().describe(
+      "Template type: standard, mission, brief, runbook, document, or checklist"
+    ),
+    category: z.string().optional().describe("Category \u2014 e.g. 'standards/fleet-shared'"),
+    contentHash: z.string().optional().describe("sha256 of content \u2014 auto-computed server-side when omitted"),
+    sourceCommit: z.string().optional().describe("Git commit SHA the template content was sourced from"),
+    sourceRepo: z.string().optional().describe("Git repo the template content was sourced from")
   },
   async (args) => {
     const id = await convex.mutation(api.templates.upsert, args);
@@ -820,6 +827,36 @@ server.tool(
     };
   }
 );
+server.tool(
+  "detect_template_drift",
+  "Return the VR-side sha256 contentHash + provenance (sourceCommit, sourceRepo) for each template in scope. IMPORTANT: Convex queries have no filesystem access. This tool returns the VR canonical contentHash so the caller can read the source file, compute its SHA256, and compare. name=<slug> filters to a single template; omit name to return every template.",
+  {
+    name: z.string().optional().describe("Template slug \u2014 filter to a single template")
+  },
+  async ({ name }) => {
+    const result = await convex.query(api.templates.detectTemplateDrift, {
+      name
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+    };
+  }
+);
+server.tool(
+  "list_templates_by_category",
+  "List templates for a specific category using the byCategory index.",
+  {
+    category: z.string().describe("Category to filter by \u2014 e.g. 'standards/fleet-shared'")
+  },
+  async ({ category }) => {
+    const result = await convex.query(api.templates.listTemplatesByCategory, {
+      category
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+    };
+  }
+);
 server.tool(
   "upsert_test_run",
   "Insert a skill quality test run and update denormalized quality fields on the parent skill (lastTestedAt, lastReviewerScore, lastEvalDelta, testStatus). reviewerScore format is 'X/Y' e.g. '37/45'. evalDelta is pp delta vs without-skill baseline.",

package/server.ts

@@ -10,7 +10,7 @@
  *   upsert_plugin, list_plugins, get_plugin
  *   upsert_hook, list_hooks, get_hook
  *   upsert_prompt, list_prompts, get_prompt
- *   upsert_template, list_templates, get_template
+ *   upsert_template, list_templates, get_template, detect_template_drift, list_templates_by_category
  *   upsert_runbook, get_runbook, list_runbooks, list_runbooks_by_category, list_runbooks_by_team, delete_runbook
  *   link_runbook_template, unlink_runbook_template, list_templates_for_runbook, list_runbooks_for_template
  *   register_component, list_components, get_component, search_components, update_component, delete_component
@@ -112,7 +112,7 @@ const runbookStatusSchema = z
 	.describe("Runbook status");
 
 const templateTypeSchema = z
-	.enum(["mission", "document", "checklist"])
+	.enum(["standard", "mission", "brief", "runbook", "document", "checklist"])
 	.describe("Template type");
 
 const linkTypeSchema = z
@@ -130,7 +130,7 @@ const convex = new ConvexHttpClient(convexUrl);
 
 const server = new McpServer({
 	name: "vantage-registry",
-	version: "1.4.0",
+	version: "1.5.0",
 });
 
 // ═══════════════════════════════════════════════════════════════════════════════
@@ -1115,7 +1115,8 @@ server.tool(
 
 server.tool(
 	"upsert_template",
-	"Create or update a template in VantageRegistry. Upserts by name.",
+	"Create or update a template in VantageRegistry. Upserts by name. " +
+		"contentHash is auto-computed server-side (sha256 of content) when omitted.",
 	{
 		name: z.string().describe("Template name — e.g. 'agent-brief', 'skill-md'"),
 		team: z
@@ -1125,6 +1126,27 @@ server.tool(
 		purpose: z.string().describe("What this template is used for"),
 		content: z.string().describe("Full template content"),
 		version: z.string().optional().describe("Semantic version — e.g. '1.0.0'"),
+		template_type: templateTypeSchema
+			.optional()
+			.describe(
+				"Template type: standard, mission, brief, runbook, document, or checklist",
+			),
+		category: z
+			.string()
+			.optional()
+			.describe("Category — e.g. 'standards/fleet-shared'"),
+		contentHash: z
+			.string()
+			.optional()
+			.describe("sha256 of content — auto-computed server-side when omitted"),
+		sourceCommit: z
+			.string()
+			.optional()
+			.describe("Git commit SHA the template content was sourced from"),
+		sourceRepo: z
+			.string()
+			.optional()
+			.describe("Git repo the template content was sourced from"),
 	},
 	async (args) => {
 		const id = await convex.mutation(api.templates.upsert, args);
@@ -1173,6 +1195,47 @@ server.tool(
 	},
 );
 
+server.tool(
+	"detect_template_drift",
+	"Return the VR-side sha256 contentHash + provenance (sourceCommit, sourceRepo) " +
+		"for each template in scope. IMPORTANT: Convex queries have no filesystem access. " +
+		"This tool returns the VR canonical contentHash so the caller can read the source " +
+		"file, compute its SHA256, and compare. name=<slug> filters to a single template; " +
+		"omit name to return every template.",
+	{
+		name: z
+			.string()
+			.optional()
+			.describe("Template slug — filter to a single template"),
+	},
+	async ({ name }) => {
+		const result = await convex.query(api.templates.detectTemplateDrift, {
+			name,
+		});
+		return {
+			content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+		};
+	},
+);
+
+server.tool(
+	"list_templates_by_category",
+	"List templates for a specific category using the byCategory index.",
+	{
+		category: z
+			.string()
+			.describe("Category to filter by — e.g. 'standards/fleet-shared'"),
+	},
+	async ({ category }) => {
+		const result = await convex.query(api.templates.listTemplatesByCategory, {
+			category,
+		});
+		return {
+			content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+		};
+	},
+);
+
 // ═══════════════════════════════════════════════════════════════════════════════
 // SKILL TEST RUNS
 // ═══════════════════════════════════════════════════════════════════════════════