@burdenoff/mcp-libs 2026.511.1

package/dist/modules/tags/index.js

@@ -0,0 +1,372 @@
+import { mcpToolName, jsonResult, errorResult } from '../../chunk-H2OYWLOA.js';
+import { z } from 'zod';
+
+// src/modules/tags/operations.ts
+var LIST_TAGS = `
+  query TagsList($filter: TagFilterInput, $pagination: TagsPaginationInput) {
+    getTags(filter: $filter, pagination: $pagination) {
+      items { id key label description scope displayOrder }
+      total hasMore
+    }
+  }
+`;
+var GET_TAG = `
+  query GetTag($id: ID!) {
+    getTag(id: $id) {
+      id key label description color icon scope vocabularyId parentId
+      displayOrder assignmentCount usageCount hierarchyLevel hierarchyPath
+    }
+  }
+`;
+var CREATE_TAG = `
+  mutation CreateTag($input: CreateTagInput!) {
+    createTag(input: $input) {
+      id key label description scope displayOrder createdAt
+    }
+  }
+`;
+var UPDATE_TAG = `
+  mutation UpdateTag($id: ID!, $input: UpdateTagInput!) {
+    updateTag(id: $id, input: $input) {
+      id label description color icon parentId displayOrder updatedAt
+    }
+  }
+`;
+var DELETE_TAG = `
+  mutation DeleteTag($id: ID!) {
+    deleteTag(id: $id)
+  }
+`;
+var TAG_ANALYTICS = `
+  query TagAnalytics($tagId: ID!, $startDate: DateTime!, $endDate: DateTime!) {
+    getTagAnalytics(tagId: $tagId, startDate: $startDate, endDate: $endDate) {
+      assignmentCount date entityTypeBreakdown uniqueUsers uniqueEntities
+    }
+  }
+`;
+var TAG_RELATIONS = `
+  query GetRelatedTags($tagId: ID!) {
+    getRelatedTags(tagId: $tagId) {
+      tag { id label }
+      relationType
+    }
+  }
+`;
+var CREATE_TAG_RELATION = `
+  mutation CreateTagRelation($input: CreateTagRelationInput!) {
+    createTagRelation(input: $input) {
+      id fromTagId toTagId relationType bidirectional
+    }
+  }
+`;
+var DELETE_TAG_RELATION = `
+  mutation DeleteTagRelation($id: ID!) {
+    deleteTagRelation(id: $id)
+  }
+`;
+
+// src/modules/tags/tools.ts
+var TagScopeEnum = z.enum(["WORKSPACE", "GLOBAL", "VIBE"]).describe("Visibility scope of the tag");
+var TagRelationTypeEnum = z.enum(["SYNONYM", "ANTONYM", "BROADER", "NARROWER", "RELATED", "IMPLIES", "EXCLUDES"]).describe(
+  "Semantic relationship between two tags (SYNONYM = same-meaning, BROADER/NARROWER = hierarchy, IMPLIES/EXCLUDES = behaviour, RELATED = generic)"
+);
+function resolveWorkspaceContext(ctx) {
+  const auth = ctx.auth.read();
+  const workspaceId = auth?.workspaceId;
+  if (!workspaceId) {
+    return {
+      ok: false,
+      error: errorResult(
+        "No workspace selected. Bind one with <product>_auth_select_workspace before calling tag tools."
+      )
+    };
+  }
+  return { ok: true, ctx: { workspaceId } };
+}
+function registerTagsTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tags_list")),
+    {
+      title: "List Tags",
+      description: "List tags in the currently-bound workspace, with optional scope/search filters and pagination. Returns { items, total, hasMore }.",
+      inputSchema: {
+        scope: TagScopeEnum.optional().describe("Filter by scope"),
+        search: z.string().optional().describe("Free-text search across key/label/description"),
+        limit: z.number().optional().describe("Page size (default 100)"),
+        offset: z.number().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ scope, search, limit, offset }) => {
+      try {
+        const wctx = resolveWorkspaceContext(ctx);
+        if (!wctx.ok) return wctx.error;
+        const filter = { workspaceId: wctx.ctx.workspaceId };
+        if (scope !== void 0) filter.scope = scope;
+        if (search !== void 0) filter.search = search;
+        const data = await ctx.gql.workspace.request(LIST_TAGS, {
+          filter,
+          pagination: { limit: limit ?? 100, offset: offset ?? 0 }
+        });
+        return jsonResult(data.getTags);
+      } catch (error) {
+        ctx.logger.error("tags_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list tags: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tags_get")),
+    {
+      title: "Get Tag",
+      description: "Fetch a single tag by ID. Returns the full detail shape (color, icon, hierarchy, usage counters).",
+      inputSchema: { id: z.string().describe("Tag ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_TAG, {
+          id
+        });
+        if (!data.getTag) {
+          return errorResult(`Tag ${id} not found`);
+        }
+        return jsonResult(data.getTag);
+      } catch (error) {
+        ctx.logger.error("tags_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get tag: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tags_create")),
+    {
+      title: "Create Tag",
+      description: "Create a tag in the currently-bound workspace. `key` must be unique within the (workspace, scope) tuple; `label` is the human-readable display name.",
+      inputSchema: {
+        key: z.string().min(1).describe("Stable identifier (kebab-case recommended); unique within workspace+scope"),
+        label: z.string().min(1).describe("Human-readable display name"),
+        description: z.string().optional().describe("Free-form description"),
+        color: z.string().optional().describe("Hex color (e.g. #ff8800) \u2014 must be a semantic theme token in UI"),
+        icon: z.string().optional().describe("Icon name (lucide-react identifier)"),
+        scope: TagScopeEnum.optional().describe("Tag scope (default WORKSPACE)"),
+        parentId: z.string().optional().describe("Parent tag ID for hierarchical taxonomies")
+      }
+    },
+    async ({ key, label, description, color, icon, scope, parentId }) => {
+      try {
+        const wctx = resolveWorkspaceContext(ctx);
+        if (!wctx.ok) return wctx.error;
+        const input = {
+          context: wctx.ctx,
+          key,
+          label,
+          scope: scope ?? "WORKSPACE"
+        };
+        if (description !== void 0) input.description = description;
+        if (color !== void 0) input.color = color;
+        if (icon !== void 0) input.icon = icon;
+        if (parentId !== void 0) input.parentId = parentId;
+        const data = await ctx.gql.workspace.request(CREATE_TAG, {
+          input
+        });
+        return jsonResult(data.createTag);
+      } catch (error) {
+        ctx.logger.error("tags_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create tag: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tags_update")),
+    {
+      title: "Update Tag",
+      description: "Update a tag. At least one mutable field (label / description / color / icon / parentId / displayOrder) must be provided. The workspace context is implicit.",
+      inputSchema: {
+        id: z.string().describe("Tag ID"),
+        label: z.string().optional().describe("Updated display name"),
+        description: z.string().optional().describe("Updated description (pass empty string to clear)"),
+        color: z.string().optional().describe("Updated hex color"),
+        icon: z.string().optional().describe("Updated icon name"),
+        parentId: z.string().optional().describe("Updated parent tag ID"),
+        displayOrder: z.number().int().optional().describe("Updated display order within parent (lower sorts first)")
+      }
+    },
+    async ({ id, label, description, color, icon, parentId, displayOrder }) => {
+      try {
+        const wctx = resolveWorkspaceContext(ctx);
+        if (!wctx.ok) return wctx.error;
+        const input = { context: wctx.ctx };
+        if (label !== void 0) input.label = label;
+        if (description !== void 0) input.description = description;
+        if (color !== void 0) input.color = color;
+        if (icon !== void 0) input.icon = icon;
+        if (parentId !== void 0) input.parentId = parentId;
+        if (displayOrder !== void 0) input.displayOrder = displayOrder;
+        if (Object.keys(input).length === 1) {
+          return errorResult(
+            "No updates specified \u2014 provide at least one of label/description/color/icon/parentId/displayOrder"
+          );
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_TAG, {
+          id,
+          input
+        });
+        return jsonResult(data.updateTag);
+      } catch (error) {
+        ctx.logger.error("tags_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update tag: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tags_delete")),
+    {
+      title: "Delete Tag",
+      description: "Permanently delete a tag and all its assignments. This is destructive \u2014 there is no soft-delete on the tags service.",
+      inputSchema: { id: z.string().describe("Tag ID to delete") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(DELETE_TAG, {
+          id
+        });
+        return jsonResult({ deleted: data.deleteTag, tagId: id });
+      } catch (error) {
+        ctx.logger.error("tags_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete tag: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tags_analytics")),
+    {
+      title: "Tag Usage Analytics",
+      description: "Time-bucketed analytics for a tag: assignmentCount, uniqueUsers, uniqueEntities, and entityType breakdown over the [from, to] window.",
+      inputSchema: {
+        tagId: z.string().describe("Tag ID to analyse"),
+        from: z.string().describe("Start of the window in ISO-8601 (DateTime)"),
+        to: z.string().describe("End of the window in ISO-8601 (DateTime)")
+      }
+    },
+    async ({ tagId, from, to }) => {
+      try {
+        const data = await ctx.gql.workspace.request(TAG_ANALYTICS, { tagId, startDate: from, endDate: to });
+        return jsonResult(data.getTagAnalytics);
+      } catch (error) {
+        ctx.logger.error("tags_analytics failed", { error: String(error) });
+        return errorResult(
+          `Failed to get tag analytics: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tags_permissions_list")),
+    {
+      title: "List Tag Relations",
+      description: "List all tag relations originating from the given tag (synonyms, hierarchy, implies/excludes, etc.).",
+      inputSchema: { tagId: z.string().describe("Tag ID") }
+    },
+    async ({ tagId }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          TAG_RELATIONS,
+          { tagId }
+        );
+        return jsonResult(data.getRelatedTags);
+      } catch (error) {
+        ctx.logger.error("tags_permissions_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list tag relations: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tags_permissions_grant")),
+    {
+      title: "Create Tag Relation",
+      description: "Create a typed relation between two tags. Set bidirectional=true to mirror the relation in both directions (only meaningful for symmetric types like SYNONYM, ANTONYM, RELATED).",
+      inputSchema: {
+        fromTagId: z.string().describe("Source tag ID"),
+        toTagId: z.string().describe("Target tag ID"),
+        relationType: TagRelationTypeEnum.describe("Relation type"),
+        bidirectional: z.boolean().optional().describe("Mirror the relation in the reverse direction (default false)")
+      }
+    },
+    async ({ fromTagId, toTagId, relationType, bidirectional }) => {
+      try {
+        const wctx = resolveWorkspaceContext(ctx);
+        if (!wctx.ok) return wctx.error;
+        const input = {
+          context: wctx.ctx,
+          fromTagId,
+          toTagId,
+          relationType,
+          bidirectional: bidirectional ?? false
+        };
+        const data = await ctx.gql.workspace.request(CREATE_TAG_RELATION, { input });
+        return jsonResult(data.createTagRelation);
+      } catch (error) {
+        ctx.logger.error("tags_permissions_grant failed", { error: String(error) });
+        return errorResult(
+          `Failed to create tag relation: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tags_permissions_revoke")),
+    {
+      title: "Delete Tag Relation",
+      description: "Delete a tag relation by its relation ID.",
+      inputSchema: { relationId: z.string().describe("Relation ID to delete") }
+    },
+    async ({ relationId }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          DELETE_TAG_RELATION,
+          { id: relationId }
+        );
+        return jsonResult({ deleted: data.deleteTagRelation, relationId });
+      } catch (error) {
+        ctx.logger.error("tags_permissions_revoke failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete tag relation: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/tags/index.ts
+var tagsModule = {
+  id: "tags",
+  version: "0.0.1",
+  displayName: "Tags",
+  dependsOn: ["auth"],
+  capabilities: { tools: {} },
+  register(server, ctx) {
+    const tools = [];
+    const track = (n) => {
+      tools.push(n);
+      return n;
+    };
+    registerTagsTools(server, ctx, track);
+    return { tools, resources: [], prompts: [] };
+  }
+};
+var tags_default = tagsModule;
+
+export { tags_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/modules/tags/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/tags/operations.ts","../../../src/modules/tags/tools.ts","../../../src/modules/tags/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Tags module GraphQL operations — CRUD + analytics + relations.\n * Ported verbatim from cli-sdk/src/modules/tags/operations.ts.\n *\n * Backend: ~/products/wspace/tags/wspace-tags-svc/.\n * Hive service name: `tags` (boundary prefix + `-svc` suffix stripped).\n */\n\nexport const LIST_TAGS = `\n  query TagsList($filter: TagFilterInput, $pagination: TagsPaginationInput) {\n    getTags(filter: $filter, pagination: $pagination) {\n      items { id key label description scope displayOrder }\n      total hasMore\n    }\n  }\n`;\n\nexport const GET_TAG = `\n  query GetTag($id: ID!) {\n    getTag(id: $id) {\n      id key label description color icon scope vocabularyId parentId\n      displayOrder assignmentCount usageCount hierarchyLevel hierarchyPath\n    }\n  }\n`;\n\nexport const CREATE_TAG = `\n  mutation CreateTag($input: CreateTagInput!) {\n    createTag(input: $input) {\n      id key label description scope displayOrder createdAt\n    }\n  }\n`;\n\nexport const UPDATE_TAG = `\n  mutation UpdateTag($id: ID!, $input: UpdateTagInput!) {\n    updateTag(id: $id, input: $input) {\n      id label description color icon parentId displayOrder updatedAt\n    }\n  }\n`;\n\nexport const DELETE_TAG = `\n  mutation DeleteTag($id: ID!) {\n    deleteTag(id: $id)\n  }\n`;\n\nexport const TAG_ANALYTICS = `\n  query TagAnalytics($tagId: ID!, $startDate: DateTime!, $endDate: DateTime!) {\n    getTagAnalytics(tagId: $tagId, startDate: $startDate, endDate: $endDate) {\n      assignmentCount date entityTypeBreakdown uniqueUsers uniqueEntities\n    }\n  }\n`;\n\nexport const TAG_RELATIONS = `\n  query GetRelatedTags($tagId: ID!) {\n    getRelatedTags(tagId: $tagId) {\n      tag { id label }\n      relationType\n    }\n  }\n`;\n\nexport const CREATE_TAG_RELATION = `\n  mutation CreateTagRelation($input: CreateTagRelationInput!) {\n    createTagRelation(input: $input) {\n      id fromTagId toTagId relationType bidirectional\n    }\n  }\n`;\n\nexport const DELETE_TAG_RELATION = `\n  mutation DeleteTagRelation($id: ID!) {\n    deleteTagRelation(id: $id)\n  }\n`;\n","/**\n * Tags MCP tools — CANONICAL reference module per CLAUDE.md.\n *\n * Surface (6 tools + 3 relation tools = 9): CRUD + analytics + relations.{list,grant,revoke}.\n * Mirrors cli-sdk/src/modules/tags/commands.ts (\"tags permissions\" Commander group ↔\n * the relation tools below — the underlying mutations are the same; \"permissions\"\n * is the user-facing surface name on the CLI side).\n *\n * Quality bar:\n *   - Tight zod enums for every backend enum (TagScope, TagRelationType)\n *   - Descriptive title + description on every tool (Claude Desktop renders these)\n *   - Detailed `.describe()` on every input field for tool-call grounding\n *   - Workspace-context guard surfaces a precise re-auth hint via errorResult\n *   - Strict types: no `any`; `unknown` + cast only at request boundaries\n */\n\nimport { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { jsonResult, errorResult, mcpToolName, type McpContext } from '../../core/index.js';\nimport * as ops from './operations.js';\n\ninterface TagRow {\n  id: string;\n  key: string;\n  label: string;\n  description?: string | null;\n  scope?: string;\n  displayOrder?: number;\n}\n\ninterface TagDetail extends TagRow {\n  color?: string | null;\n  icon?: string | null;\n  vocabularyId?: string | null;\n  parentId?: string | null;\n  assignmentCount?: number;\n  usageCount?: number;\n  hierarchyLevel?: number;\n  hierarchyPath?: string[];\n}\n\ninterface RelatedTag {\n  tag: { id: string; label: string };\n  relationType: string;\n}\n\nconst TagScopeEnum = z\n  .enum(['WORKSPACE', 'GLOBAL', 'VIBE'])\n  .describe('Visibility scope of the tag');\n\nconst TagRelationTypeEnum = z\n  .enum(['SYNONYM', 'ANTONYM', 'BROADER', 'NARROWER', 'RELATED', 'IMPLIES', 'EXCLUDES'])\n  .describe(\n    'Semantic relationship between two tags (SYNONYM = same-meaning, BROADER/NARROWER = hierarchy, IMPLIES/EXCLUDES = behaviour, RELATED = generic)',\n  );\n\ninterface WorkspaceCtx {\n  workspaceId: string;\n}\n\n/**\n * Resolve the bound workspace context from the auth store. The tags service\n * requires `context.workspaceId` on every mutation input.\n *\n * Returns `errorResult` shape via the `error` channel when no workspace is\n * bound — the caller MUST short-circuit on that signal.\n */\nfunction resolveWorkspaceContext(\n  ctx: McpContext,\n): { ok: true; ctx: WorkspaceCtx } | { ok: false; error: ReturnType<typeof errorResult> } {\n  const auth = ctx.auth.read();\n  const workspaceId = auth?.workspaceId;\n  if (!workspaceId) {\n    return {\n      ok: false,\n      error: errorResult(\n        'No workspace selected. Bind one with <product>_auth_select_workspace before calling tag tools.',\n      ),\n    };\n  }\n  return { ok: true, ctx: { workspaceId } };\n}\n\nexport function registerTagsTools(\n  server: McpServer,\n  ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  // ── CRUD ────────────────────────────────────────────────────────────────\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tags_list')),\n    {\n      title: 'List Tags',\n      description:\n        'List tags in the currently-bound workspace, with optional scope/search filters and pagination. Returns { items, total, hasMore }.',\n      inputSchema: {\n        scope: TagScopeEnum.optional().describe('Filter by scope'),\n        search: z.string().optional().describe('Free-text search across key/label/description'),\n        limit: z.number().optional().describe('Page size (default 100)'),\n        offset: z.number().optional().describe('Pagination offset (default 0)'),\n      },\n    },\n    async ({ scope, search, limit, offset }) => {\n      try {\n        const wctx = resolveWorkspaceContext(ctx);\n        if (!wctx.ok) return wctx.error;\n\n        const filter: Record<string, unknown> = { workspaceId: wctx.ctx.workspaceId };\n        if (scope !== undefined) filter.scope = scope;\n        if (search !== undefined) filter.search = search;\n\n        const data = await ctx.gql.workspace.request<{\n          getTags: { items: TagRow[]; total: number; hasMore: boolean };\n        }>(ops.LIST_TAGS, {\n          filter,\n          pagination: { limit: limit ?? 100, offset: offset ?? 0 },\n        });\n        return jsonResult(data.getTags);\n      } catch (error) {\n        ctx.logger.error('tags_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to list tags: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tags_get')),\n    {\n      title: 'Get Tag',\n      description:\n        'Fetch a single tag by ID. Returns the full detail shape (color, icon, hierarchy, usage counters).',\n      inputSchema: { id: z.string().describe('Tag ID') },\n    },\n    async ({ id }) => {\n      try {\n        const data = await ctx.gql.workspace.request<{ getTag: TagDetail | null }>(ops.GET_TAG, {\n          id,\n        });\n        if (!data.getTag) {\n          return errorResult(`Tag ${id} not found`);\n        }\n        return jsonResult(data.getTag);\n      } catch (error) {\n        ctx.logger.error('tags_get failed', { error: String(error) });\n        return errorResult(\n          `Failed to get tag: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tags_create')),\n    {\n      title: 'Create Tag',\n      description:\n        'Create a tag in the currently-bound workspace. `key` must be unique within the (workspace, scope) tuple; `label` is the human-readable display name.',\n      inputSchema: {\n        key: z\n          .string()\n          .min(1)\n          .describe('Stable identifier (kebab-case recommended); unique within workspace+scope'),\n        label: z.string().min(1).describe('Human-readable display name'),\n        description: z.string().optional().describe('Free-form description'),\n        color: z\n          .string()\n          .optional()\n          .describe('Hex color (e.g. #ff8800) — must be a semantic theme token in UI'),\n        icon: z.string().optional().describe('Icon name (lucide-react identifier)'),\n        scope: TagScopeEnum.optional().describe('Tag scope (default WORKSPACE)'),\n        parentId: z.string().optional().describe('Parent tag ID for hierarchical taxonomies'),\n      },\n    },\n    async ({ key, label, description, color, icon, scope, parentId }) => {\n      try {\n        const wctx = resolveWorkspaceContext(ctx);\n        if (!wctx.ok) return wctx.error;\n\n        const input: Record<string, unknown> = {\n          context: wctx.ctx,\n          key,\n          label,\n          scope: scope ?? 'WORKSPACE',\n        };\n        if (description !== undefined) input.description = description;\n        if (color !== undefined) input.color = color;\n        if (icon !== undefined) input.icon = icon;\n        if (parentId !== undefined) input.parentId = parentId;\n\n        const data = await ctx.gql.workspace.request<{ createTag: TagRow }>(ops.CREATE_TAG, {\n          input,\n        });\n        return jsonResult(data.createTag);\n      } catch (error) {\n        ctx.logger.error('tags_create failed', { error: String(error) });\n        return errorResult(\n          `Failed to create tag: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tags_update')),\n    {\n      title: 'Update Tag',\n      description:\n        'Update a tag. At least one mutable field (label / description / color / icon / parentId / displayOrder) must be provided. The workspace context is implicit.',\n      inputSchema: {\n        id: z.string().describe('Tag ID'),\n        label: z.string().optional().describe('Updated display name'),\n        description: z\n          .string()\n          .optional()\n          .describe('Updated description (pass empty string to clear)'),\n        color: z.string().optional().describe('Updated hex color'),\n        icon: z.string().optional().describe('Updated icon name'),\n        parentId: z.string().optional().describe('Updated parent tag ID'),\n        displayOrder: z\n          .number()\n          .int()\n          .optional()\n          .describe('Updated display order within parent (lower sorts first)'),\n      },\n    },\n    async ({ id, label, description, color, icon, parentId, displayOrder }) => {\n      try {\n        const wctx = resolveWorkspaceContext(ctx);\n        if (!wctx.ok) return wctx.error;\n\n        const input: Record<string, unknown> = { context: wctx.ctx };\n        if (label !== undefined) input.label = label;\n        if (description !== undefined) input.description = description;\n        if (color !== undefined) input.color = color;\n        if (icon !== undefined) input.icon = icon;\n        if (parentId !== undefined) input.parentId = parentId;\n        if (displayOrder !== undefined) input.displayOrder = displayOrder;\n\n        // `context` is always present so length === 1 means no real updates.\n        if (Object.keys(input).length === 1) {\n          return errorResult(\n            'No updates specified — provide at least one of label/description/color/icon/parentId/displayOrder',\n          );\n        }\n\n        const data = await ctx.gql.workspace.request<{ updateTag: TagRow }>(ops.UPDATE_TAG, {\n          id,\n          input,\n        });\n        return jsonResult(data.updateTag);\n      } catch (error) {\n        ctx.logger.error('tags_update failed', { error: String(error) });\n        return errorResult(\n          `Failed to update tag: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tags_delete')),\n    {\n      title: 'Delete Tag',\n      description:\n        'Permanently delete a tag and all its assignments. This is destructive — there is no soft-delete on the tags service.',\n      inputSchema: { id: z.string().describe('Tag ID to delete') },\n    },\n    async ({ id }) => {\n      try {\n        const data = await ctx.gql.workspace.request<{ deleteTag: boolean }>(ops.DELETE_TAG, {\n          id,\n        });\n        return jsonResult({ deleted: data.deleteTag, tagId: id });\n      } catch (error) {\n        ctx.logger.error('tags_delete failed', { error: String(error) });\n        return errorResult(\n          `Failed to delete tag: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  // ── Analytics ───────────────────────────────────────────────────────────\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tags_analytics')),\n    {\n      title: 'Tag Usage Analytics',\n      description:\n        'Time-bucketed analytics for a tag: assignmentCount, uniqueUsers, uniqueEntities, and entityType breakdown over the [from, to] window.',\n      inputSchema: {\n        tagId: z.string().describe('Tag ID to analyse'),\n        from: z.string().describe('Start of the window in ISO-8601 (DateTime)'),\n        to: z.string().describe('End of the window in ISO-8601 (DateTime)'),\n      },\n    },\n    async ({ tagId, from, to }) => {\n      try {\n        const data = await ctx.gql.workspace.request<{\n          getTagAnalytics: Record<string, unknown>;\n        }>(ops.TAG_ANALYTICS, { tagId, startDate: from, endDate: to });\n        return jsonResult(data.getTagAnalytics);\n      } catch (error) {\n        ctx.logger.error('tags_analytics failed', { error: String(error) });\n        return errorResult(\n          `Failed to get tag analytics: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  // ── Relations (CLI's \"permissions\" group is named for the user-facing\n  //   semantic — under the hood these are tag-relation mutations) ──────────\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tags_permissions_list')),\n    {\n      title: 'List Tag Relations',\n      description:\n        'List all tag relations originating from the given tag (synonyms, hierarchy, implies/excludes, etc.).',\n      inputSchema: { tagId: z.string().describe('Tag ID') },\n    },\n    async ({ tagId }) => {\n      try {\n        const data = await ctx.gql.workspace.request<{ getRelatedTags: RelatedTag[] }>(\n          ops.TAG_RELATIONS,\n          { tagId },\n        );\n        return jsonResult(data.getRelatedTags);\n      } catch (error) {\n        ctx.logger.error('tags_permissions_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to list tag relations: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tags_permissions_grant')),\n    {\n      title: 'Create Tag Relation',\n      description:\n        'Create a typed relation between two tags. Set bidirectional=true to mirror the relation in both directions (only meaningful for symmetric types like SYNONYM, ANTONYM, RELATED).',\n      inputSchema: {\n        fromTagId: z.string().describe('Source tag ID'),\n        toTagId: z.string().describe('Target tag ID'),\n        relationType: TagRelationTypeEnum.describe('Relation type'),\n        bidirectional: z\n          .boolean()\n          .optional()\n          .describe('Mirror the relation in the reverse direction (default false)'),\n      },\n    },\n    async ({ fromTagId, toTagId, relationType, bidirectional }) => {\n      try {\n        const wctx = resolveWorkspaceContext(ctx);\n        if (!wctx.ok) return wctx.error;\n\n        const input: Record<string, unknown> = {\n          context: wctx.ctx,\n          fromTagId,\n          toTagId,\n          relationType,\n          bidirectional: bidirectional ?? false,\n        };\n        const data = await ctx.gql.workspace.request<{\n          createTagRelation: Record<string, unknown>;\n        }>(ops.CREATE_TAG_RELATION, { input });\n        return jsonResult(data.createTagRelation);\n      } catch (error) {\n        ctx.logger.error('tags_permissions_grant failed', { error: String(error) });\n        return errorResult(\n          `Failed to create tag relation: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tags_permissions_revoke')),\n    {\n      title: 'Delete Tag Relation',\n      description: 'Delete a tag relation by its relation ID.',\n      inputSchema: { relationId: z.string().describe('Relation ID to delete') },\n    },\n    async ({ relationId }) => {\n      try {\n        const data = await ctx.gql.workspace.request<{ deleteTagRelation: boolean }>(\n          ops.DELETE_TAG_RELATION,\n          { id: relationId },\n        );\n        return jsonResult({ deleted: data.deleteTagRelation, relationId });\n      } catch (error) {\n        ctx.logger.error('tags_permissions_revoke failed', { error: String(error) });\n        return errorResult(\n          `Failed to delete tag relation: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n}\n","/**\n * Tags module — CANONICAL reference module per CLAUDE.md.\n *\n * Tools: <product>_tags_{list,get,create,update,delete,analytics} +\n * <product>_tags_relations_{list,grant,revoke}.\n *\n * Backend: ~/products/wspace/tags/wspace-tags-svc/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerTagsTools } from './tools.js';\n\nconst tagsModule: McpModule = {\n  id: 'tags',\n  version: '0.0.1',\n  displayName: 'Tags',\n  dependsOn: ['auth'],\n  capabilities: { tools: {} },\n  register(server: McpServer, ctx: McpContext): ModuleRegistration {\n    const tools: string[] = [];\n    const track = (n: string): string => {\n      tools.push(n);\n      return n;\n    };\n    registerTagsTools(server, ctx, track);\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default tagsModule;\n"]}

package/dist/modules/tours/index.cjs

@@ -0,0 +1,225 @@
+'use strict';
+
+var zod = require('zod');
+require('graphql-request');
+require('cross-fetch');
+require('@modelcontextprotocol/sdk/server/mcp.js');
+require('@modelcontextprotocol/sdk/types.js');
+
+// src/modules/tours/tools.ts
+
+// src/core/errors.ts
+var McpInternalError = class extends Error {
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.name = "McpInternalError";
+    this.cause = cause;
+  }
+};
+
+// src/core/result.ts
+function jsonResult(data, structured) {
+  const result = {
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+  };
+  return result;
+}
+function errorResult(message, hint) {
+  const text = hint ? `${message}
+
+Hint: ${hint}` : message;
+  return { content: [{ type: "text", text }], isError: true };
+}
+
+// src/core/tool-name.ts
+var MAX_TOOL_NAME_LENGTH = 63;
+function assertSafeName(name, kind) {
+  if (name.length > MAX_TOOL_NAME_LENGTH) {
+    throw new McpInternalError(
+      `Tool name '${name}' exceeds ${MAX_TOOL_NAME_LENGTH} characters (some MCP clients truncate at 64).`
+    );
+  }
+  return name;
+}
+function mcpToolName(productName, ...parts) {
+  if (!productName) {
+    throw new McpInternalError("mcpToolName: productName is required");
+  }
+  const name = [productName, ...parts].filter(Boolean).join("_");
+  return assertSafeName(name);
+}
+
+// src/modules/tours/operations.ts
+var LIST_TOURS = `
+  query ListTours($filters: TourFilters, $pagination: TourPagination) {
+    tours(filters: $filters, pagination: $pagination) {
+      tours {
+        id
+        name
+        slug
+        description
+        status
+        isActive
+        productId
+        moduleId
+        priority
+        displayOrder
+        createdAt
+        updatedAt
+      }
+      total
+      hasMore
+    }
+  }
+`;
+var GET_USER_TOUR_PROGRESS = `
+  query GetUserTourProgress($userId: ID, $pagination: TourPagination) {
+    userTourProgresses(userId: $userId, pagination: $pagination) {
+      id
+      tourId
+      userId
+      status
+      currentStepId
+      currentStepOrder
+      completedSteps
+      skippedSteps
+      startedAt
+      completedAt
+      lastViewedAt
+    }
+  }
+`;
+var RESET_TOUR_PROGRESS = `
+  mutation ResetTourProgress($tourId: ID!, $userId: ID!) {
+    resetTourProgress(tourId: $tourId, userId: $userId) {
+      id
+      tourId
+      status
+      currentStepId
+      currentStepOrder
+    }
+  }
+`;
+
+// src/modules/tours/tools.ts
+function registerToursTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tours_list")),
+    {
+      title: "List Tours",
+      description: "List available product tours.",
+      inputSchema: {
+        productId: zod.z.string().optional().describe("Filter by productId"),
+        moduleId: zod.z.string().optional().describe("Filter by moduleId"),
+        status: zod.z.string().optional().describe("Filter by status"),
+        isActive: zod.z.boolean().optional().describe("Only active tours"),
+        limit: zod.z.number().optional().describe("Page size"),
+        offset: zod.z.number().optional().describe("Offset for pagination")
+      }
+    },
+    async ({ productId, moduleId, status, isActive, limit, offset }) => {
+      try {
+        const filters = {};
+        if (productId !== void 0) filters.productId = productId;
+        if (moduleId !== void 0) filters.moduleId = moduleId;
+        if (status !== void 0) filters.status = status.toUpperCase();
+        if (isActive !== void 0) filters.isActive = isActive;
+        const data = await ctx.gql.global.request(LIST_TOURS, {
+          filters: Object.keys(filters).length ? filters : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.tours);
+      } catch (error) {
+        ctx.logger.error("tours_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list tours: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tours_progress_get")),
+    {
+      title: "Get Tour Progress",
+      description: "Get the current user's tour progress, optionally filtered by user id.",
+      inputSchema: {
+        userId: zod.z.string().optional().describe("User ID (defaults to current actor)"),
+        limit: zod.z.number().optional().describe("Page size"),
+        offset: zod.z.number().optional().describe("Offset for pagination")
+      }
+    },
+    async ({ userId, limit, offset }) => {
+      try {
+        const data = await ctx.gql.global.request(
+          GET_USER_TOUR_PROGRESS,
+          {
+            userId,
+            pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+          }
+        );
+        return jsonResult(data.userTourProgresses);
+      } catch (error) {
+        ctx.logger.error("tours_progress_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get tour progress: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tours_progress_reset")),
+    {
+      title: "Reset Tour Progress",
+      description: "Reset tour progress for the given user (defaults to the current actor).",
+      inputSchema: {
+        tourId: zod.z.string().describe("Tour ID"),
+        userId: zod.z.string().optional().describe("User ID (defaults to current actor)")
+      }
+    },
+    async ({ tourId, userId }) => {
+      try {
+        const auth = ctx.auth.read();
+        const resolvedUserId = userId ?? auth?.workspaceId;
+        if (!resolvedUserId) {
+          return errorResult(
+            "Unable to resolve user; pass userId or authenticate to a workspace first."
+          );
+        }
+        const data = await ctx.gql.global.request(
+          RESET_TOUR_PROGRESS,
+          { tourId, userId: resolvedUserId }
+        );
+        return jsonResult(data.resetTourProgress);
+      } catch (error) {
+        ctx.logger.error("tours_progress_reset failed", { error: String(error) });
+        return errorResult(
+          `Failed to reset tour progress: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/tours/index.ts
+var toursModule = {
+  id: "tours",
+  version: "0.0.1",
+  displayName: "Tours",
+  dependsOn: ["auth"],
+  capabilities: { tools: {} },
+  register(server, ctx) {
+    const tools = [];
+    const track = (n) => {
+      tools.push(n);
+      return n;
+    };
+    registerToursTools(server, ctx, track);
+    return { tools, resources: [], prompts: [] };
+  }
+};
+var tours_default = toursModule;
+
+module.exports = tours_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map