product-spec-mcp 0.3.27 → 0.3.29

package/README.md

@@ -61,7 +61,7 @@ npm run dev
 ```bash
 PRODUCT_SPEC_REMOTE_GATE_URL=https://gate.example.com/v1/pm-intent
 PRODUCT_SPEC_REMOTE_GATE_TOKEN=replace-with-token
-PRODUCT_SPEC_REMOTE_GATE_TIMEOUT_MS=2500
+PRODUCT_SPEC_REMOTE_GATE_TIMEOUT_MS=10000
 PRODUCT_SPEC_REMOTE_GATE_MODE=auto
 PRODUCT_SPEC_TELEMETRY=off
 ```

package/dist/index.cjs

@@ -23811,7 +23811,7 @@ function decideRecommendedDeployment(needType, technicalShape, maintenanceMode,
   if (accessTopology === "lan_only") return "local_lan_server_sqlite";
   if (accessTopology === "internet_ip") return "cheap_vps_sqlite_by_ip";
   if (accessTopology === "public_domain") return "vps_domain_https";
-  if (technicalShape === "light_backend_json_sqlite") return "cheap_vps_sqlite_by_ip";
+  if (technicalShape === "light_backend_json_sqlite") return "unknown";
   return "unknown";
 }
 function decideRoute(needType, technicalShape, maintenanceMode) {
@@ -23833,13 +23833,19 @@ function enforceHardRules(decision) {
       needType: "multi_user_collaboration",
       maintenanceMode: "runtime_collaboration",
       technicalShape: "light_backend_json_sqlite",
-      recommendedDeployment: decision.accessTopology === "lan_only" ? "local_lan_server_sqlite" : "cheap_vps_sqlite_by_ip",
+      recommendedDeployment: recommendedDeploymentForCollaboration(decision.accessTopology),
       route: "spec_interrogate",
       mustNotUse: Array.from(/* @__PURE__ */ new Set([...decision.mustNotUse, "static_display", "local_storage_only"]))
     };
   }
   return decision;
 }
+function recommendedDeploymentForCollaboration(accessTopology) {
+  if (accessTopology === "lan_only") return "local_lan_server_sqlite";
+  if (accessTopology === "internet_ip") return "cheap_vps_sqlite_by_ip";
+  if (accessTopology === "public_domain") return "vps_domain_https";
+  return "unknown";
+}
 function buildMustNotUse(needType, maintenanceMode) {
   const items = [];
   if (needType === "multi_user_collaboration") items.push("static_display", "local_storage_only");
@@ -27702,7 +27708,7 @@ async function callRemotePmIntentGate(message, context, localDecision) {
   const url = process.env.PRODUCT_SPEC_REMOTE_GATE_URL;
   if (!url) return null;
   const controller = new AbortController();
-  const timeout = Number(process.env.PRODUCT_SPEC_REMOTE_GATE_TIMEOUT_MS || 2500);
+  const timeout = Number(process.env.PRODUCT_SPEC_REMOTE_GATE_TIMEOUT_MS || 1e4);
   const timer = setTimeout(() => controller.abort(), timeout);
   try {
     const response = await fetch(url, {
@@ -27874,6 +27880,7 @@ function enforceRemoteHardRules(remote, local) {
       needType: "multi_user_collaboration",
       maintenanceMode: "runtime_collaboration",
       technicalShape: "light_backend_json_sqlite",
+      recommendedDeployment: recommendedDeploymentForCollaboration2(remote.accessTopology),
       route: "spec_interrogate",
       mustNotUse: mergeStrings(remote.mustNotUse, ["static_display", "local_storage_only"])
     };
@@ -27891,6 +27898,12 @@ function enforceRemoteHardRules(remote, local) {
   }
   return remote;
 }
+function recommendedDeploymentForCollaboration2(accessTopology) {
+  if (accessTopology === "lan_only") return "local_lan_server_sqlite";
+  if (accessTopology === "internet_ip") return "cheap_vps_sqlite_by_ip";
+  if (accessTopology === "public_domain") return "vps_domain_https";
+  return "unknown";
+}
 function hasRouteShapeConflict(decision) {
   return decision.route === "architecture_decide" && decision.technicalShape !== "static_page";
 }
@@ -29682,7 +29695,7 @@ function registerProductSpecAssist(server) {
 function createServer() {
   const server = new McpServer({
     name: "product-spec-mcp",
-    version: "0.3.27"
+    version: "0.3.29"
   });
   registerSpecInterrogate(server);
   registerSpecCompile(server);

package/docs/online-pm-gate.md

@@ -7,7 +7,7 @@ P0 online gate is an HTTP classifier for low-confidence or conflicting local PM
 ```bash
 PRODUCT_SPEC_REMOTE_GATE_URL=https://gate.example.com/v1/pm-intent
 PRODUCT_SPEC_REMOTE_GATE_TOKEN=replace-with-token
-PRODUCT_SPEC_REMOTE_GATE_TIMEOUT_MS=2500
+PRODUCT_SPEC_REMOTE_GATE_TIMEOUT_MS=10000
 PRODUCT_SPEC_REMOTE_GATE_MODE=auto
 PRODUCT_SPEC_TELEMETRY=off
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "product-spec-mcp",
-  "version": "0.3.27",
+  "version": "0.3.29",
   "description": "MCP Server for product specification - requirement interrogation, architecture decision, UI translation, debug guidance, and acceptance generation",
   "type": "commonjs",
   "main": "dist/index.cjs",

package/workers/pm-intent-gate.mjs

@@ -137,7 +137,21 @@ function isAuthorized(request, env) {
 
 function buildGatePrompt(message, rule, choices) {
   return JSON.stringify({
-    task: "Choose the best PM gate only. Return strict JSON, no markdown.",
+    task: "Choose the best PM gate only. Return strict JSON only.",
+    example: {
+      bestGate: "data_visualization_site",
+      usageScope: "self",
+      maintenanceMode: "agent_assisted",
+      accessTopology: "single_device",
+      confidence: "medium",
+      strongSignals: ["xlsx"],
+      weakSignals: ["website"],
+      coreObjects: ["xlsx file"],
+      states: [],
+      actions: ["parse xlsx", "render chart"],
+      mustNotUse: ["admin_backend_by_default"],
+      boundaryQuestionIds: ["data_update_mode"],
+    },
     output: {
       bestGate: "one needType enum",
       usageScope: "one usageScope enum",
@@ -193,15 +207,25 @@ async function callOpenAiCompatible(llm, prompt) {
       model: llm.model,
       temperature: 0.1,
       max_tokens: 600,
+      response_format: { type: "json_object" },
       messages: [
-        { role: "system", content: "You are a terse product intent classifier. Output JSON only." },
+        {
+          role: "system",
+          content: [
+            "You are a terse product intent classifier.",
+            "Return exactly one valid JSON object.",
+            "Do not use markdown, code fences, comments, or prose.",
+            "Use only enum values supplied by the user.",
+          ].join(" "),
+        },
         { role: "user", content: prompt },
       ],
     }),
   });
   if (!response.ok) throw new Error(`${llm.provider}_http_${response.status}`);
   const data = await response.json();
-  const content = data?.choices?.[0]?.message?.content;
+  if (data?.error) throw new Error(`${llm.provider}_error_${data.error.code || data.error.type || "unknown"}`);
+  const content = extractOpenAiCompatibleContent(data);
   if (typeof content !== "string" || !content.trim()) throw new Error(`${llm.provider}_empty_content`);
   return content;
 }
@@ -210,21 +234,79 @@ function normalizeBaseUrl(baseUrl) {
   return String(baseUrl || "").replace(/\/+$/, "");
 }
 
+function extractOpenAiCompatibleContent(data) {
+  const choice = data?.choices?.[0];
+  const message = choice?.message || {};
+  const content = message.content;
+  if (typeof content === "string" && content.trim()) return content;
+  if (Array.isArray(content)) {
+    const text = content
+      .map((part) => {
+        if (typeof part === "string") return part;
+        if (typeof part?.text === "string") return part.text;
+        if (typeof part?.content === "string") return part.content;
+        return "";
+      })
+      .join("");
+    if (text.trim()) return text;
+  }
+  if (typeof message.reasoning_content === "string" && message.reasoning_content.trim()) return message.reasoning_content;
+  if (typeof choice?.text === "string" && choice.text.trim()) return choice.text;
+  if (typeof data?.output_text === "string" && data.output_text.trim()) return data.output_text;
+  return "";
+}
+
 function extractJson(text) {
   try {
     return JSON.parse(text);
   } catch {
-    const start = text.indexOf("{");
-    const end = text.lastIndexOf("}");
-    if (start < 0 || end <= start) return null;
+    const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    if (fenced) {
+      try {
+        return JSON.parse(fenced[1]);
+      } catch {
+        // Continue to balanced object extraction below.
+      }
+    }
+    const candidate = extractFirstBalancedObject(text);
+    if (!candidate) return null;
     try {
-      return JSON.parse(text.slice(start, end + 1));
+      return JSON.parse(candidate);
     } catch {
       return null;
     }
   }
 }
 
+function extractFirstBalancedObject(text) {
+  const start = text.indexOf("{");
+  if (start < 0) return "";
+  let depth = 0;
+  let inString = false;
+  let escaped = false;
+  for (let i = start; i < text.length; i += 1) {
+    const char = text[i];
+    if (inString) {
+      if (escaped) {
+        escaped = false;
+      } else if (char === "\\") {
+        escaped = true;
+      } else if (char === "\"") {
+        inString = false;
+      }
+      continue;
+    }
+    if (char === "\"") {
+      inString = true;
+      continue;
+    }
+    if (char === "{") depth += 1;
+    if (char === "}") depth -= 1;
+    if (depth === 0) return text.slice(start, i + 1);
+  }
+  return "";
+}
+
 function sanitizeDecision(raw) {
   if (!raw || typeof raw !== "object") return null;
   const bestGate = raw.bestGate || raw.needType;