@vantageos/vantage-registry-mcp 1.1.1 → 1.2.0

package/package.json

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

package/server.ts

@@ -12,6 +12,7 @@
  *   upsert_prompt, list_prompts, get_prompt
  *   upsert_template, list_templates, get_template
  *   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
  *   get_stats
  *
  * Orchestrator: Omega — VantageOS Team | 2026-05-19
@@ -111,6 +112,12 @@ const templateTypeSchema = z
 	.enum(["mission", "document", "checklist"])
 	.describe("Template type");
 
+const linkTypeSchema = z
+	.enum(["uses", "produces", "references"])
+	.describe(
+		"Link type — uses: template consumed during execution, produces: output document generated, references: informational cross-reference",
+	);
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Server setup
 // ─────────────────────────────────────────────────────────────────────────────
@@ -120,7 +127,7 @@ const convex = new ConvexHttpClient(convexUrl);
 
 const server = new McpServer({
 	name: "vantage-registry",
-	version: "1.1.1",
+	version: "1.2.0",
 });
 
 // ═══════════════════════════════════════════════════════════════════════════════
@@ -1197,6 +1204,218 @@ server.tool(
 	},
 );
 
+// ═══════════════════════════════════════════════════════════════════════════════
+// RUNBOOK ↔ TEMPLATE LINKS (Sprint B T4 — junction table typed links)
+// ═══════════════════════════════════════════════════════════════════════════════
+
+server.tool(
+	"link_runbook_template",
+	"Create or update a typed link between a runbook and a template in the runbook_template_links junction table. " +
+		"Upserts by (runbookId, templateId) pair — at-most-one link per pair. " +
+		"linkType controls the relationship semantics: " +
+		"'uses' = template consumed during execution, " +
+		"'produces' = output document generated by this runbook, " +
+		"'references' = informational cross-reference. " +
+		"Returns {linkId, created: true} on insert or {linkId, created: false} on update.",
+	{
+		runbookId: z.string().describe("Convex document ID for the runbook"),
+		templateId: z.string().describe("Convex document ID for the template"),
+		linkType: linkTypeSchema,
+		usagePhase: z
+			.string()
+			.optional()
+			.describe(
+				"Phase name where this template is used — kebab-case convention e.g. 'bootstrap', 'audit-phase-2'",
+			),
+		order: z
+			.number()
+			.optional()
+			.describe(
+				"Sort order for template lists — lower numbers appear first (null items sorted last)",
+			),
+		createdBy: z
+			.string()
+			.optional()
+			.describe("Orchestrator or person creating this link — e.g. 'omega'"),
+	},
+	async (args) => {
+		try {
+			const result = await convex.mutation(
+				api.runbookTemplateLinks.linkRunbookTemplate,
+				{
+					runbookId: args.runbookId as any,
+					templateId: args.templateId as any,
+					linkType: args.linkType,
+					usagePhase: args.usagePhase,
+					order: args.order,
+					createdBy: args.createdBy,
+				},
+			);
+			return {
+				content: [
+					{
+						type: "text",
+						text: JSON.stringify({ success: true, data: result }, null, 2),
+					},
+				],
+			};
+		} catch (err) {
+			return {
+				content: [
+					{
+						type: "text",
+						text: JSON.stringify(
+							{ success: false, error: String(err) },
+							null,
+							2,
+						),
+					},
+				],
+			};
+		}
+	},
+);
+
+server.tool(
+	"unlink_runbook_template",
+	"Hard-delete the typed link between a runbook and a template. " +
+		"Links have no lifecycle state — they either exist or they don't (no soft-delete). " +
+		"Returns {unlinked: true} if the link was found and deleted, {unlinked: false} if the pair was not linked.",
+	{
+		runbookId: z.string().describe("Convex document ID for the runbook"),
+		templateId: z.string().describe("Convex document ID for the template"),
+	},
+	async (args) => {
+		try {
+			const result = await convex.mutation(
+				api.runbookTemplateLinks.unlinkRunbookTemplate,
+				{
+					runbookId: args.runbookId as any,
+					templateId: args.templateId as any,
+				},
+			);
+			return {
+				content: [
+					{
+						type: "text",
+						text: JSON.stringify({ success: true, data: result }, null, 2),
+					},
+				],
+			};
+		} catch (err) {
+			return {
+				content: [
+					{
+						type: "text",
+						text: JSON.stringify(
+							{ success: false, error: String(err) },
+							null,
+							2,
+						),
+					},
+				],
+			};
+		}
+	},
+);
+
+server.tool(
+	"list_templates_for_runbook",
+	"List all templates linked to a runbook, with enriched template metadata. " +
+		"Returns enriched [{link, template}] objects sorted by link.order ASC then link.createdAt ASC. " +
+		"Optionally filter by linkType ('uses', 'produces', or 'references'). " +
+		"Orphaned links (template deleted) are automatically skipped.",
+	{
+		runbookId: z.string().describe("Convex document ID for the runbook"),
+		linkType: linkTypeSchema
+			.optional()
+			.describe(
+				"Filter by link type — omit to return all link types for this runbook",
+			),
+	},
+	async (args) => {
+		try {
+			const result = await convex.query(
+				api.runbookTemplateLinks.listTemplatesForRunbook,
+				{
+					runbookId: args.runbookId as any,
+					linkType: args.linkType,
+				},
+			);
+			return {
+				content: [
+					{
+						type: "text",
+						text: JSON.stringify({ success: true, data: result }, null, 2),
+					},
+				],
+			};
+		} catch (err) {
+			return {
+				content: [
+					{
+						type: "text",
+						text: JSON.stringify(
+							{ success: false, error: String(err) },
+							null,
+							2,
+						),
+					},
+				],
+			};
+		}
+	},
+);
+
+server.tool(
+	"list_runbooks_for_template",
+	"List all runbooks linked to a template (reverse lookup), with enriched runbook metadata. " +
+		"Symmetric reverse of list_templates_for_runbook — uses the byTemplate index. " +
+		"Returns enriched [{link, runbook}] objects sorted by link.order ASC then link.createdAt ASC. " +
+		"Optionally filter by linkType ('uses', 'produces', or 'references'). " +
+		"Orphaned links (runbook deleted) are automatically skipped.",
+	{
+		templateId: z.string().describe("Convex document ID for the template"),
+		linkType: linkTypeSchema
+			.optional()
+			.describe(
+				"Filter by link type — omit to return all link types for this template",
+			),
+	},
+	async (args) => {
+		try {
+			const result = await convex.query(
+				api.runbookTemplateLinks.listRunbooksForTemplate,
+				{
+					templateId: args.templateId as any,
+					linkType: args.linkType,
+				},
+			);
+			return {
+				content: [
+					{
+						type: "text",
+						text: JSON.stringify({ success: true, data: result }, null, 2),
+					},
+				],
+			};
+		} catch (err) {
+			return {
+				content: [
+					{
+						type: "text",
+						text: JSON.stringify(
+							{ success: false, error: String(err) },
+							null,
+							2,
+						),
+					},
+				],
+			};
+		}
+	},
+);
+
 // ═══════════════════════════════════════════════════════════════════════════════
 // STATS
 // ═══════════════════════════════════════════════════════════════════════════════