@systemdox/mcp-server 0.1.13 → 0.1.15

package/dist/cli.js

@@ -246,6 +246,27 @@ var init_deprecation = __esm({
   }
 });
 
+// src/lib/config-links.ts
+async function workspaceBase(apiClient2) {
+  try {
+    const access = await apiClient2.get(
+      "/v1/docs/portal-access"
+    );
+    const slug = (access.host ?? "").split(".")[0];
+    return slug ? `https://${slug}.systemdox.com` : null;
+  } catch {
+    return null;
+  }
+}
+function configLink(path, base) {
+  return base ? `${base}${path}` : `${path} in your SystemDox workspace`;
+}
+var init_config_links = __esm({
+  "src/lib/config-links.ts"() {
+    "use strict";
+  }
+});
+
 // src/tools/get-guardrails.ts
 import { z } from "zod";
 function registerGetGuardrails(server2, apiClient2) {
@@ -268,13 +289,9 @@ function registerGetGuardrails(server2, apiClient2) {
       );
     }
     if (filtered.length === 0) {
+      const text2 = guardrails.length === 0 ? `No checks found. Add checks at ${configLink("/docs/guardrails", await workspaceBase(apiClient2))}` : `No checks found${lang ? ` for language "${lang}"` : ""}${category ? ` in category "${category}"` : ""}.`;
       return {
-        content: [
-          {
-            type: "text",
-            text: `No checks found${lang ? ` for language "${lang}"` : ""}${category ? ` in category "${category}"` : ""}.`
-          }
-        ]
+        content: [{ type: "text", text: text2 }]
       };
     }
     const text = filtered.map(
@@ -331,6 +348,7 @@ var init_get_guardrails = __esm({
     "use strict";
     init_language();
     init_deprecation();
+    init_config_links();
     DESCRIPTION = "Retrieve SystemDox checks (banned patterns, required patterns, coding rules). Filter by language, category, or file path to get only relevant checks.";
     inputSchema = () => ({
       language: z.string().optional().describe(
@@ -559,7 +577,7 @@ function registerGetTechStack(server2, apiClient2) {
           content: [
             {
               type: "text",
-              text: "No tech stack entries configured."
+              text: `No tech stack entries configured. Add your stack at ${configLink("/docs/tech-stack", await workspaceBase(apiClient2))}`
             }
           ]
         };
@@ -593,6 +611,7 @@ ${sections}`
 var init_get_tech_stack = __esm({
   "src/tools/get-tech-stack.ts"() {
     "use strict";
+    init_config_links();
   }
 });
 
@@ -976,13 +995,19 @@ async function hydrate(api, item, meta) {
 }
 async function buildContext(api, { taskDescription, filePaths = [], maxTokens }) {
   const budget = maxTokens ?? DEFAULT_BUDGET;
-  const [guardrails, specs, docs, stack, rules] = await Promise.all([
+  const [rawGuardrails, rawSpecs, docs, stack, rules, docRepos] = await Promise.all([
     api.get("/v1/guardrails").catch(() => []),
     api.get("/v1/specs").catch(() => []),
     api.get("/v1/docs").catch(() => ({ items: [] })),
     api.get("/v1/ai/settings/stack").catch(() => []),
-    api.get("/v1/standards/rules").catch(() => [])
+    api.get("/v1/standards/rules").catch(() => []),
+    // Capability states — FAIL-OPEN: an unreadable config (older backend, a
+    // blip) gates nothing, it can never hide working context.
+    api.get("/v1/doc-repos").catch(() => null)
   ]);
+  const disabled = (key2) => docRepos?.capabilities?.[key2]?.status === "disabled";
+  const guardrails = disabled("fitness") ? [] : rawGuardrails;
+  const specs = disabled("requirements") && disabled("design") && disabled("specs") ? [] : rawSpecs;
   const refs = /* @__PURE__ */ new Map();
   const key = (type, id) => `${type}:${id}`;
   const scorable = [
@@ -1521,13 +1546,9 @@ function registerGetProjectRules(server2, apiClient2) {
         );
       }
       if (filtered.length === 0) {
+        const text2 = rules.length === 0 ? `No project rules found. Add rules at ${configLink("/docs/rules", await workspaceBase(apiClient2))}` : `No project rules found${category ? ` in category "${category}"` : ""}.`;
         return {
-          content: [
-            {
-              type: "text",
-              text: `No project rules found${category ? ` in category "${category}"` : ""}.`
-            }
-          ]
+          content: [{ type: "text", text: text2 }]
         };
       }
       const grouped = /* @__PURE__ */ new Map();
@@ -1565,6 +1586,7 @@ var CATEGORY_LABELS;
 var init_get_project_rules = __esm({
   "src/tools/get-project-rules.ts"() {
     "use strict";
+    init_config_links();
     CATEGORY_LABELS = {
       deployment: "Deployment",
       architecture: "Architecture",
@@ -1635,7 +1657,7 @@ function registerGetPromptTemplates(server2, apiClient2) {
           content: [
             {
               type: "text",
-              text: "No prompt templates found."
+              text: `No prompt templates found. Add templates at ${configLink("/docs/prompts", await workspaceBase(apiClient2))}`
             }
           ]
         };
@@ -1665,6 +1687,7 @@ ${text}`
 var init_get_prompt_templates = __esm({
   "src/tools/get-prompt-templates.ts"() {
     "use strict";
+    init_config_links();
   }
 });
 

package/dist/http.js

@@ -200,6 +200,22 @@ function legacyToolDescription(canonical, description) {
   return `DEPRECATED \u2014 use \`${canonical}\` instead. This name still works and will not be removed before ${LEGACY_TOOL_REMOVAL_EARLIEST}. ${description}`;
 }
 
+// src/lib/config-links.ts
+async function workspaceBase(apiClient) {
+  try {
+    const access = await apiClient.get(
+      "/v1/docs/portal-access"
+    );
+    const slug = (access.host ?? "").split(".")[0];
+    return slug ? `https://${slug}.systemdox.com` : null;
+  } catch {
+    return null;
+  }
+}
+function configLink(path, base) {
+  return base ? `${base}${path}` : `${path} in your SystemDox workspace`;
+}
+
 // src/tools/get-guardrails.ts
 var DESCRIPTION = "Retrieve SystemDox checks (banned patterns, required patterns, coding rules). Filter by language, category, or file path to get only relevant checks.";
 var inputSchema = () => ({
@@ -233,13 +249,9 @@ function registerGetGuardrails(server, apiClient) {
       );
     }
     if (filtered.length === 0) {
+      const text2 = guardrails.length === 0 ? `No checks found. Add checks at ${configLink("/docs/guardrails", await workspaceBase(apiClient))}` : `No checks found${lang ? ` for language "${lang}"` : ""}${category ? ` in category "${category}"` : ""}.`;
       return {
-        content: [
-          {
-            type: "text",
-            text: `No checks found${lang ? ` for language "${lang}"` : ""}${category ? ` in category "${category}"` : ""}.`
-          }
-        ]
+        content: [{ type: "text", text: text2 }]
       };
     }
     const text = filtered.map(
@@ -494,7 +506,7 @@ function registerGetTechStack(server, apiClient) {
           content: [
             {
               type: "text",
-              text: "No tech stack entries configured."
+              text: `No tech stack entries configured. Add your stack at ${configLink("/docs/tech-stack", await workspaceBase(apiClient))}`
             }
           ]
         };
@@ -927,13 +939,19 @@ async function hydrate(api, item, meta) {
 }
 async function buildContext(api, { taskDescription, filePaths = [], maxTokens }) {
   const budget = maxTokens ?? DEFAULT_BUDGET;
-  const [guardrails, specs, docs, stack, rules] = await Promise.all([
+  const [rawGuardrails, rawSpecs, docs, stack, rules, docRepos] = await Promise.all([
     api.get("/v1/guardrails").catch(() => []),
     api.get("/v1/specs").catch(() => []),
     api.get("/v1/docs").catch(() => ({ items: [] })),
     api.get("/v1/ai/settings/stack").catch(() => []),
-    api.get("/v1/standards/rules").catch(() => [])
+    api.get("/v1/standards/rules").catch(() => []),
+    // Capability states — FAIL-OPEN: an unreadable config (older backend, a
+    // blip) gates nothing, it can never hide working context.
+    api.get("/v1/doc-repos").catch(() => null)
   ]);
+  const disabled = (key2) => docRepos?.capabilities?.[key2]?.status === "disabled";
+  const guardrails = disabled("fitness") ? [] : rawGuardrails;
+  const specs = disabled("requirements") && disabled("design") && disabled("specs") ? [] : rawSpecs;
   const refs = /* @__PURE__ */ new Map();
   const key = (type, id) => `${type}:${id}`;
   const scorable = [
@@ -1418,13 +1436,9 @@ function registerGetProjectRules(server, apiClient) {
         );
       }
       if (filtered.length === 0) {
+        const text2 = rules.length === 0 ? `No project rules found. Add rules at ${configLink("/docs/rules", await workspaceBase(apiClient))}` : `No project rules found${category ? ` in category "${category}"` : ""}.`;
         return {
-          content: [
-            {
-              type: "text",
-              text: `No project rules found${category ? ` in category "${category}"` : ""}.`
-            }
-          ]
+          content: [{ type: "text", text: text2 }]
         };
       }
       const grouped = /* @__PURE__ */ new Map();
@@ -1513,7 +1527,7 @@ function registerGetPromptTemplates(server, apiClient) {
           content: [
             {
               type: "text",
-              text: "No prompt templates found."
+              text: `No prompt templates found. Add templates at ${configLink("/docs/prompts", await workspaceBase(apiClient))}`
             }
           ]
         };

package/dist/index.js

@@ -216,6 +216,22 @@ function legacyToolDescription(canonical, description) {
   return `DEPRECATED \u2014 use \`${canonical}\` instead. This name still works and will not be removed before ${LEGACY_TOOL_REMOVAL_EARLIEST}. ${description}`;
 }
 
+// src/lib/config-links.ts
+async function workspaceBase(apiClient2) {
+  try {
+    const access = await apiClient2.get(
+      "/v1/docs/portal-access"
+    );
+    const slug = (access.host ?? "").split(".")[0];
+    return slug ? `https://${slug}.systemdox.com` : null;
+  } catch {
+    return null;
+  }
+}
+function configLink(path, base) {
+  return base ? `${base}${path}` : `${path} in your SystemDox workspace`;
+}
+
 // src/tools/get-guardrails.ts
 var DESCRIPTION = "Retrieve SystemDox checks (banned patterns, required patterns, coding rules). Filter by language, category, or file path to get only relevant checks.";
 var inputSchema = () => ({
@@ -249,13 +265,9 @@ function registerGetGuardrails(server2, apiClient2) {
       );
     }
     if (filtered.length === 0) {
+      const text2 = guardrails.length === 0 ? `No checks found. Add checks at ${configLink("/docs/guardrails", await workspaceBase(apiClient2))}` : `No checks found${lang ? ` for language "${lang}"` : ""}${category ? ` in category "${category}"` : ""}.`;
       return {
-        content: [
-          {
-            type: "text",
-            text: `No checks found${lang ? ` for language "${lang}"` : ""}${category ? ` in category "${category}"` : ""}.`
-          }
-        ]
+        content: [{ type: "text", text: text2 }]
       };
     }
     const text = filtered.map(
@@ -510,7 +522,7 @@ function registerGetTechStack(server2, apiClient2) {
           content: [
             {
               type: "text",
-              text: "No tech stack entries configured."
+              text: `No tech stack entries configured. Add your stack at ${configLink("/docs/tech-stack", await workspaceBase(apiClient2))}`
             }
           ]
         };
@@ -943,13 +955,19 @@ async function hydrate(api, item, meta) {
 }
 async function buildContext(api, { taskDescription, filePaths = [], maxTokens }) {
   const budget = maxTokens ?? DEFAULT_BUDGET;
-  const [guardrails, specs, docs, stack, rules] = await Promise.all([
+  const [rawGuardrails, rawSpecs, docs, stack, rules, docRepos] = await Promise.all([
     api.get("/v1/guardrails").catch(() => []),
     api.get("/v1/specs").catch(() => []),
     api.get("/v1/docs").catch(() => ({ items: [] })),
     api.get("/v1/ai/settings/stack").catch(() => []),
-    api.get("/v1/standards/rules").catch(() => [])
+    api.get("/v1/standards/rules").catch(() => []),
+    // Capability states — FAIL-OPEN: an unreadable config (older backend, a
+    // blip) gates nothing, it can never hide working context.
+    api.get("/v1/doc-repos").catch(() => null)
   ]);
+  const disabled = (key2) => docRepos?.capabilities?.[key2]?.status === "disabled";
+  const guardrails = disabled("fitness") ? [] : rawGuardrails;
+  const specs = disabled("requirements") && disabled("design") && disabled("specs") ? [] : rawSpecs;
   const refs = /* @__PURE__ */ new Map();
   const key = (type, id) => `${type}:${id}`;
   const scorable = [
@@ -1434,13 +1452,9 @@ function registerGetProjectRules(server2, apiClient2) {
         );
       }
       if (filtered.length === 0) {
+        const text2 = rules.length === 0 ? `No project rules found. Add rules at ${configLink("/docs/rules", await workspaceBase(apiClient2))}` : `No project rules found${category ? ` in category "${category}"` : ""}.`;
         return {
-          content: [
-            {
-              type: "text",
-              text: `No project rules found${category ? ` in category "${category}"` : ""}.`
-            }
-          ]
+          content: [{ type: "text", text: text2 }]
         };
       }
       const grouped = /* @__PURE__ */ new Map();
@@ -1529,7 +1543,7 @@ function registerGetPromptTemplates(server2, apiClient2) {
           content: [
             {
               type: "text",
-              text: "No prompt templates found."
+              text: `No prompt templates found. Add templates at ${configLink("/docs/prompts", await workspaceBase(apiClient2))}`
             }
           ]
         };

package/dist/lib/config-links.d.ts

@@ -0,0 +1,18 @@
+import type { SystemDoxApiClient } from "./api-client.js";
+/**
+ * The tenant's workspace base URL (https://{slug}.systemdox.com), or null
+ * when it can't be resolved. The slug is the first label of the portal host
+ * that GET /v1/docs/portal-access reports — the API builds that host as
+ * `{slug}.{DOCS_DOMAIN}`, so the first label is the slug whichever docs
+ * domain is live. The GET goes through the api client's response cache, so
+ * repeated empty states don't re-fetch.
+ */
+export declare function workspaceBase(apiClient: SystemDoxApiClient): Promise<string | null>;
+/**
+ * Where to add missing configuration: a full URL when the workspace base is
+ * known, the in-app path otherwise.
+ *
+ * Mirrored by apps/app/src/pages/ai/mcpPreview.ts — keep the output
+ * byte-identical when either side changes.
+ */
+export declare function configLink(path: string, base: string | null): string;

package/dist/lib/config-links.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+// src/lib/config-links.ts
+async function workspaceBase(apiClient) {
+  try {
+    const access = await apiClient.get(
+      "/v1/docs/portal-access"
+    );
+    const slug = (access.host ?? "").split(".")[0];
+    return slug ? `https://${slug}.systemdox.com` : null;
+  } catch {
+    return null;
+  }
+}
+function configLink(path, base) {
+  return base ? `${base}${path}` : `${path} in your SystemDox workspace`;
+}
+export {
+  configLink,
+  workspaceBase
+};

package/dist/lib/context-builder.js

@@ -403,13 +403,19 @@ async function hydrate(api, item, meta) {
 }
 async function buildContext(api, { taskDescription, filePaths = [], maxTokens }) {
   const budget = maxTokens ?? DEFAULT_BUDGET;
-  const [guardrails, specs, docs, stack, rules] = await Promise.all([
+  const [rawGuardrails, rawSpecs, docs, stack, rules, docRepos] = await Promise.all([
     api.get("/v1/guardrails").catch(() => []),
     api.get("/v1/specs").catch(() => []),
     api.get("/v1/docs").catch(() => ({ items: [] })),
     api.get("/v1/ai/settings/stack").catch(() => []),
-    api.get("/v1/standards/rules").catch(() => [])
+    api.get("/v1/standards/rules").catch(() => []),
+    // Capability states — FAIL-OPEN: an unreadable config (older backend, a
+    // blip) gates nothing, it can never hide working context.
+    api.get("/v1/doc-repos").catch(() => null)
   ]);
+  const disabled = (key2) => docRepos?.capabilities?.[key2]?.status === "disabled";
+  const guardrails = disabled("fitness") ? [] : rawGuardrails;
+  const specs = disabled("requirements") && disabled("design") && disabled("specs") ? [] : rawSpecs;
   const refs = /* @__PURE__ */ new Map();
   const key = (type, id) => `${type}:${id}`;
   const scorable = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@systemdox/mcp-server",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "type": "module",
   "description": "MCP server that exposes SystemDox checks, specs, docs, and tech stack to AI coding tools",
   "main": "./dist/index.js",