@nextfreelatech/xpec-mcp 1.0.1

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -0,0 +1,84 @@
+// Build the MCP server, register tools/resources, and connect a stdio
+// transport. Kept distinct from the CLI so tests can construct the server
+// without spawning a child process.
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { XpecClient } from "./client.js";
+import { McpToolError } from "./errors.js";
+import { logger } from "./logger.js";
+import { registerReadTools, registerWriteTools } from "./tools.js";
+import { registerResources } from "./resources.js";
+const SERVER_NAME = "@nextfreelatech/xpec-mcp";
+const SERVER_VERSION = "1.0.1";
+export function buildServer(options) {
+    const { config } = options;
+    if (!config.token) {
+        throw new Error("XPEC_API_TOKEN is required. Generate one at /settings/developer.");
+    }
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+            logging: {},
+        },
+    });
+    const client = options.client ??
+        new XpecClient({ apiUrl: config.apiUrl, token: config.token });
+    registerReadTools(server, { client, config });
+    registerWriteTools(server, { client, config });
+    registerResources(server, { client, config });
+    return server;
+}
+/**
+ * Resolves only when the transport's `onclose` fires. Used to keep the
+ * stdio process alive after `server.connect()` returns — without this, the
+ * CLI exits before the agent can send `initialize`.
+ */
+export function waitForTransportClose(transport) {
+    return new Promise((resolve) => {
+        const prev = transport.onclose;
+        transport.onclose = () => {
+            prev?.();
+            resolve();
+        };
+    });
+}
+export async function runStdio(config) {
+    const server = buildServer({ config });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("mcp server connected", {
+        transport: "stdio",
+        apiUrl: config.apiUrl,
+        apiUrlSource: config.apiUrlSource,
+        bindingMode: config.bindingMode,
+        workspaceId: config.workspaceId ?? undefined,
+        workspaceSource: config.workspaceSource,
+        productId: config.productId ?? undefined,
+        productSource: config.productSource,
+    });
+    await waitForTransportClose(transport);
+}
+/**
+ * Phase 4 startup probe: detect the legacy `.xpec.json` shape
+ * (`{"workspaceId": "<old id>"}` whose value is now a Product id, not a
+ * Workspace id) and emit `LEGACY_BINDING_DETECTED` with an exact remediation
+ * (per mcp-workspace-tools.md §5). Returns `null` when the binding looks
+ * fine; returns an `McpToolError` the CLI can print and exit on.
+ *
+ * Triggers when:
+ *   * `workspaceId` is set on the binding, AND
+ *   * the API confirms it resolves to a Product (not a Workspace).
+ *
+ * Best-effort: API errors other than 404 propagate so transient connectivity
+ * problems don't masquerade as the legacy shape.
+ */
+export async function detectLegacyBinding(config, client) {
+    if (!config.workspaceId)
+        return null;
+    const shape = await client.resolveIdShape(config.workspaceId);
+    if (shape !== "product")
+        return null;
+    return new McpToolError("LEGACY_BINDING_DETECTED", `The "workspaceId" in .xpec.json (${config.workspaceId}) refers to a Product under the new model.`, 'Edit .xpec.json: rename "workspaceId" to "productId" to keep current behaviour. To bind a Workspace, create one and set both ids.');
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools.js

@@ -0,0 +1,398 @@
+// Tool registration for the MCP server (per Xpec spec "mcp-server" §6
+// "Tool naming"). Read-only surface for MVP — write tools land with
+// feature #4 (MCP Specification Version Tools).
+import { z } from "zod";
+import { McpToolError, buildClientFailure, } from "./errors.js";
+import { logger } from "./logger.js";
+/**
+ * Resolves the effective product id — explicit argument wins, then the
+ * config's `productId` (file or env). Throws PRODUCT_NOT_BOUND when
+ * neither is present.
+ */
+function requireProductId(config, explicit) {
+    if (explicit && explicit.length > 0)
+        return explicit;
+    if (config.productId)
+        return config.productId;
+    throw new McpToolError("PRODUCT_NOT_BOUND", "No product is bound to this MCP session.", "Call list_products, pick one, then add it to .xpec.json or set XPEC_PRODUCT_ID.");
+}
+/**
+ * Phase 4: Workspace counterpart. Throws WORKSPACE_NOT_BOUND when the
+ * binding doesn't include a Workspace id.
+ */
+function requireWorkspaceId(config, explicit) {
+    if (explicit && explicit.length > 0)
+        return explicit;
+    if (config.workspaceId)
+        return config.workspaceId;
+    throw new McpToolError("WORKSPACE_NOT_BOUND", "No workspace is bound to this MCP session.", "Call list_workspaces, pick one, then add it to .xpec.json as `workspaceId` or set XPEC_WORKSPACE_ID.");
+}
+/**
+ * Phase 4 default-scope resolution for `list_specifications`:
+ *   * Both binding ids set                → Product's specs
+ *   * workspaceId only                    → Workspace's own specs
+ *   * productId only                      → Product's specs
+ *   * Explicit `scope` arg                → honoured (with the matching id
+ *                                            from args or the binding)
+ */
+function resolveListSpecificationsTarget(config, args) {
+    // Explicit scope wins — but the corresponding id must resolve.
+    if (args.scope === "workspace") {
+        return { scope: "workspace", id: requireWorkspaceId(config, args.workspaceId) };
+    }
+    if (args.scope === "product") {
+        return { scope: "product", id: requireProductId(config, args.productId) };
+    }
+    // Explicit ids without a scope arg also win.
+    if (args.productId) {
+        return { scope: "product", id: args.productId };
+    }
+    if (args.workspaceId) {
+        return { scope: "workspace", id: args.workspaceId };
+    }
+    // Fall back to the binding-mode default per spec §3.
+    if (config.productId)
+        return { scope: "product", id: config.productId };
+    if (config.workspaceId)
+        return { scope: "workspace", id: config.workspaceId };
+    throw new McpToolError("PRODUCT_NOT_BOUND", "No product or workspace is bound to this MCP session.", "Call list_products or list_workspaces to discover ids, then bind in .xpec.json.");
+}
+/**
+ * Search defaults to the Workspace cross-scope endpoint when bound to a
+ * Workspace; that endpoint searches both Workspace specs and every member
+ * Product. With only a Product binding it falls through to the
+ * Product-scoped search.
+ */
+function resolveSearchSpecificationsTarget(config, args) {
+    if (args.scope === "workspace") {
+        return { scope: "workspace", id: requireWorkspaceId(config, args.workspaceId) };
+    }
+    if (args.scope === "product") {
+        return { scope: "product", id: requireProductId(config, args.productId) };
+    }
+    if (args.workspaceId) {
+        return { scope: "workspace", id: args.workspaceId };
+    }
+    if (args.productId) {
+        return { scope: "product", id: args.productId };
+    }
+    if (config.workspaceId) {
+        return { scope: "workspace", id: config.workspaceId };
+    }
+    if (config.productId) {
+        return { scope: "product", id: config.productId };
+    }
+    throw new McpToolError("PRODUCT_NOT_BOUND", "No product or workspace is bound to this MCP session.", "Call list_products or list_workspaces to discover ids, then bind in .xpec.json.");
+}
+function ok(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        structuredContent: typeof data === "object" && data !== null
+            ? data
+            : { value: data },
+    };
+}
+function fail(failure) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${failure.code}: ${failure.message}\n\n${failure.remediation}`,
+            },
+        ],
+        isError: true,
+        structuredContent: failure,
+    };
+}
+/**
+ * Wrap an async tool body so any thrown McpToolError translates to a
+ * structured tool failure. Anything else maps to INTERNAL_ERROR — agents
+ * can decide whether to retry. Tool calls also emit a debug log line
+ * matching the spec's `tool / productId / specId / durationMs / errorCode`
+ * shape.
+ */
+async function runTool(name, context, body) {
+    const startedAt = Date.now();
+    try {
+        const result = await body();
+        logger.debug("tool", {
+            tool: name,
+            durationMs: Date.now() - startedAt,
+            ...context,
+        });
+        return result;
+    }
+    catch (err) {
+        const durationMs = Date.now() - startedAt;
+        if (err instanceof McpToolError) {
+            logger.warn("tool failed", {
+                tool: name,
+                durationMs,
+                errorCode: err.code,
+                ...context,
+            });
+            return fail(err.toFailure());
+        }
+        logger.error("tool crashed", {
+            tool: name,
+            durationMs,
+            errorCode: "INTERNAL_ERROR",
+            err: err.message,
+            ...context,
+        });
+        return fail(buildClientFailure("INTERNAL_ERROR", err.message ?? "Unexpected MCP server error."));
+    }
+}
+export function registerReadTools(server, deps) {
+    const { client, config } = deps;
+    server.registerTool("list_products", {
+        title: "List products",
+        description: "List Products visible to this token. With a Workspace binding, returns the Workspace's member Products; without, returns orphan Products (Products not attached to any Workspace). Read-only. Use this to discover a productId to bind.",
+        inputSchema: {
+            workspaceId: z.string().optional(),
+        },
+    }, async (args) => runTool("list_products", { workspaceId: args.workspaceId }, async () => {
+        // Default: when bound to a Workspace, list its member Products.
+        // Otherwise list orphan Products so the agent can pick one to bind.
+        const explicit = args.workspaceId;
+        const wsId = explicit ?? config.workspaceId ?? undefined;
+        const res = await client.listProducts(wsId ? { workspaceId: wsId } : { orphan: true });
+        return ok(res.body);
+    }));
+    server.registerTool("list_workspaces", {
+        title: "List workspaces",
+        description: "List Workspaces visible to this token. Read-only. Use this when discovering which Workspace to bind in .xpec.json.",
+        inputSchema: {},
+    }, async () => runTool("list_workspaces", {}, async () => {
+        const res = await client.listWorkspaces();
+        return ok(res.body);
+    }));
+    server.registerTool("read_product", {
+        title: "Read a product",
+        description: "Read a Product's metadata: name, description, specificationManagementType, and member-of Workspace (when set). Read-only.",
+        inputSchema: {
+            productId: z.string().optional(),
+        },
+    }, async (args) => runTool("read_product", { productId: args.productId }, async () => {
+        const productId = requireProductId(config, args.productId);
+        const res = await client.readProduct(productId);
+        return ok(res.body);
+    }));
+    server.registerTool("read_workspace", {
+        title: "Read a workspace",
+        description: "Read a Workspace's metadata: name, description, specificationManagementType, archived state. Read-only.",
+        inputSchema: {
+            workspaceId: z.string().optional(),
+        },
+    }, async (args) => runTool("read_workspace", { workspaceId: args.workspaceId }, async () => {
+        const wsId = requireWorkspaceId(config, args.workspaceId);
+        const res = await client.readWorkspace(wsId);
+        return ok(res.body);
+    }));
+    server.registerTool("list_specifications", {
+        title: "List specifications",
+        description: "List specifications in scope. Read-only. Default scope follows the binding: when both workspaceId and productId are bound, lists the Product's specs; with only workspaceId, lists the Workspace's own specs; with only productId, lists the Product's specs. Pass `scope` and/or `productId`/`workspaceId` to override. Filters are type-aware: Free scopes accept folder/tag; Web Application Products accept the BUSINESS/UX/DESIGN_SYSTEM type filter.",
+        inputSchema: {
+            scope: z.enum(["workspace", "product"]).optional(),
+            productId: z.string().optional(),
+            workspaceId: z.string().optional(),
+            type: z
+                .enum(["BUSINESS", "UX", "DESIGN_SYSTEM", "DOCUMENT"])
+                .optional(),
+            status: z
+                .enum(["DRAFT", "GENERATING", "NEEDS_REVIEW", "REVIEWED"])
+                .optional(),
+            folder: z.string().optional(),
+            tags: z.array(z.string()).optional(),
+            query: z.string().optional(),
+            cursor: z.string().optional(),
+            limit: z.number().int().min(1).max(100).optional(),
+        },
+    }, async (args) => runTool("list_specifications", {
+        scope: args.scope,
+        productId: args.productId,
+        workspaceId: args.workspaceId,
+    }, async () => {
+        const target = resolveListSpecificationsTarget(config, args);
+        const query = {
+            type: args.type,
+            status: args.status,
+            folder: args.folder,
+            tags: args.tags,
+            query: args.query,
+            cursor: args.cursor,
+            limit: args.limit,
+        };
+        const res = target.scope === "workspace"
+            ? await client.listSpecificationsForWorkspace(target.id, query)
+            : await client.listSpecifications(target.id, query);
+        return ok(res.body);
+    }));
+    server.registerTool("search_specifications", {
+        title: "Search specifications",
+        description: "Lexical full-text search across spec titles and content. Read-only. With a Workspace binding, searches both the Workspace's specs and every member Product; results carry a `scope` discriminator. With only a Product binding, searches that Product's specs.",
+        inputSchema: {
+            scope: z.enum(["workspace", "product"]).optional(),
+            productId: z.string().optional(),
+            workspaceId: z.string().optional(),
+            query: z.string().min(1).max(200),
+            limit: z.number().int().min(1).max(50).optional(),
+            includeArchived: z.boolean().optional(),
+        },
+    }, async (args) => runTool("search_specifications", {
+        scope: args.scope,
+        productId: args.productId,
+        workspaceId: args.workspaceId,
+    }, async () => {
+        const target = resolveSearchSpecificationsTarget(config, args);
+        const query = {
+            query: args.query,
+            limit: args.limit,
+            includeArchived: args.includeArchived,
+        };
+        const res = target.scope === "workspace"
+            ? await client.searchSpecificationsForWorkspace(target.id, query)
+            : await client.searchSpecifications(target.id, query);
+        return ok(res.body);
+    }));
+    server.registerTool("read_specification", {
+        title: "Read a specification",
+        description: 'Read the current Markdown content of a specification. Read-only. Returns the document plus status and version. Use format="rendered" when the agent should ignore open-question and assumption markers.',
+        inputSchema: {
+            specId: z.string().min(1),
+            format: z.enum(["raw", "rendered"]).optional(),
+        },
+    }, async (args) => runTool("read_specification", { specId: args.specId }, async () => {
+        const res = await client.readSpecification(args.specId, {
+            format: args.format,
+        });
+        if ("notModified" in res) {
+            // Not reachable from a tool call (no If-None-Match passed) but
+            // typed exhaustively for safety.
+            return ok({ notModified: true, etag: res.etag });
+        }
+        return ok(res.body);
+    }));
+    server.registerTool("list_specification_versions", {
+        title: "List approved versions",
+        description: "List the approved (user-marked Reviewed) snapshots for a specification, newest first. Read-only.",
+        inputSchema: {
+            specId: z.string().min(1),
+        },
+    }, async (args) => runTool("list_specification_versions", { specId: args.specId }, async () => {
+        const res = await client.listSpecificationVersions(args.specId);
+        return ok(res.body);
+    }));
+    server.registerTool("read_specification_version", {
+        title: "Read an approved version",
+        description: "Read the full Markdown of a specific approved revision. Read-only. Use this with list_specification_versions to compare past wording with current content.",
+        inputSchema: {
+            specId: z.string().min(1),
+            revisionId: z.string().min(1),
+        },
+    }, async (args) => runTool("read_specification_version", { specId: args.specId }, async () => {
+        const res = await client.readSpecificationVersion(args.specId, args.revisionId);
+        if ("notModified" in res) {
+            return ok({ notModified: true, etag: res.etag });
+        }
+        return ok(res.body);
+    }));
+    server.registerTool("list_open_questions", {
+        title: "List open questions",
+        description: "List the questions and assumptions attached to a specification. Read-only. Resolved or dismissed items are excluded by default; pass includeResolved=true to surface the full set.",
+        inputSchema: {
+            specId: z.string().min(1),
+            includeResolved: z.boolean().optional(),
+        },
+    }, async (args) => runTool("list_open_questions", { specId: args.specId }, async () => {
+        const res = await client.listOpenQuestions(args.specId, {
+            includeResolved: args.includeResolved,
+        });
+        return ok(res.body);
+    }));
+}
+export function registerWriteTools(server, deps) {
+    const { client, config } = deps;
+    server.registerTool("start_new_version", {
+        title: "Start a new draft",
+        description: "Open a new draft of a Reviewed specification. Side effect: status becomes Draft. Does not bump the user-visible version. Required before update_specification_content on a published spec. No-op when the spec is already in Draft (response carries hint=\"already_draft\").",
+        inputSchema: { specId: z.string().min(1) },
+    }, async (args) => runTool("start_new_version", { specId: args.specId }, async () => {
+        const res = await client.startNewVersion(args.specId);
+        return ok(res.body);
+    }));
+    server.registerTool("update_specification_content", {
+        title: "Replace a draft's full content",
+        description: "Replace the entire Markdown body of a Draft specification. Side effect: content + OCC version are updated. Pass `version` from the most recent read to detect concurrent edits. Returns 409 STALE_VERSION when another writer landed first — re-read and retry.",
+        inputSchema: {
+            specId: z.string().min(1),
+            content: z.string().max(1_000_000),
+            version: z.number().int().min(1),
+        },
+    }, async (args) => runTool("update_specification_content", { specId: args.specId }, async () => {
+        const res = await client.updateSpecificationContent(args.specId, {
+            content: args.content,
+            version: args.version,
+        });
+        return ok(res.body);
+    }));
+    server.registerTool("update_specification_section", {
+        title: "Replace a single section of a draft",
+        description: 'Replace one heading-bound section of a Draft specification (e.g. sectionPath="## Pricing"). Side effect: the section text is replaced atomically and a before-image revision is recorded. OCC-guarded — pass `version` from the most recent read.',
+        inputSchema: {
+            specId: z.string().min(1),
+            sectionPath: z.string().trim().min(1).max(200),
+            newSection: z.string().max(1_000_000),
+            version: z.number().int().min(1),
+        },
+    }, async (args) => runTool("update_specification_section", { specId: args.specId }, async () => {
+        const res = await client.updateSpecificationSection(args.specId, {
+            sectionPath: args.sectionPath,
+            newSection: args.newSection,
+            version: args.version,
+        });
+        return ok(res.body);
+    }));
+    server.registerTool("request_review", {
+        title: "Request review on a draft",
+        description: "Move a Draft specification to Needs Review so a human can mark it Reviewed in Xpec. Gated on the spec having no open questions — if questions remain, the response returns OPEN_QUESTIONS_PRESENT and the agent should surface them to the user.",
+        inputSchema: { specId: z.string().min(1) },
+    }, async (args) => runTool("request_review", { specId: args.specId }, async () => {
+        const res = await client.requestReview(args.specId);
+        return ok(res.body);
+    }));
+    server.registerTool("discard_draft", {
+        title: "Discard the current draft",
+        description: "Roll a Draft (or Needs Review) specification back to its last approved version. Side effect: content is restored from the latest approved revision and status returns to Reviewed. Rejected when the spec has never been approved.",
+        inputSchema: { specId: z.string().min(1) },
+    }, async (args) => runTool("discard_draft", { specId: args.specId }, async () => {
+        const res = await client.discardDraft(args.specId);
+        return ok(res.body);
+    }));
+    // Free-spec creation only makes sense when the bound product is Free.
+    // The API enforces this with PRODUCT_TYPE_MISMATCH, but the tool stays
+    // listed unconditionally so the agent can call it after binding to a
+    // Free product — the type check at call time matches the spec's
+    // documented behaviour better than an opaque "tool not found".
+    server.registerTool("create_free_specification", {
+        title: "Create a Free product specification",
+        description: "Create a new Markdown specification in the bound Free product. Side effect: a new spec row is created at status=Draft, approvedVersion=1. Path uniqueness is enforced. Rejected with PRODUCT_TYPE_MISMATCH when the product is Web Application — use start_new_version on an existing structured spec instead.",
+        inputSchema: {
+            productId: z.string().optional(),
+            title: z.string().min(1).max(200),
+            path: z.string().optional(),
+            tags: z.array(z.string()).optional(),
+            content: z.string().optional(),
+        },
+    }, async (args) => runTool("create_free_specification", { productId: args.productId }, async () => {
+        const wsId = requireProductId(config, args.productId);
+        const res = await client.createFreeSpecification(wsId, {
+            title: args.title,
+            path: args.path,
+            tags: args.tags,
+            content: args.content,
+        });
+        return ok(res.body);
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@nextfreelatech/xpec-mcp",
+  "version": "1.0.1",
+  "description": "Model Context Protocol server for Xpec — exposes a workspace's specifications to local AI coding agents.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.22"
+  },
+  "bin": {
+    "xpec-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nextfreela/xpec-mcp.git",
+    "directory": "."
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "dotenv": "^17.4.2",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.4",
+    "tsx": "^4.21.0",
+    "typescript": "^5",
+    "vitest": "^4.1.5"
+  }
+}