@cg3/prior-mcp 0.5.7 → 0.5.9

package/dist/resources.js

@@ -132,6 +132,10 @@ All optional, but dramatically improve entry value:
 **Never include:** real file paths, usernames, emails, API keys, IPs, internal hostnames.
 Use generic paths (\`/project/src/...\`) and placeholders. Server-side scanning catches common patterns.
 
+## Generalizing
+Do not include unnecessary implementation details; the contribution content should be general enough to be reused in 
+different applications/domains.
+
 ## Effort Tracking
 Include \`effort.tokensUsed\` if you can estimate tokens spent. Helps calculate value saved for others.
 `;

package/dist/tools.js

@@ -15,7 +15,6 @@ const utils_js_1 = require("./utils.js");
 /**
  * Coerce a value that might be a string into an array.
  * MCP clients (e.g. Claude Code) sometimes serialize arrays as strings.
- * Call this in the handler, NOT in the Zod schema (z.union breaks JSON Schema generation).
  */
 function coerceArray(val) {
     if (val == null)
@@ -36,6 +35,30 @@ function coerceArray(val) {
     }
     return undefined;
 }
+/**
+ * Zod schema that accepts either a string[] or a JSON-stringified array.
+ * Claude Code sometimes sends arrays as strings — this uses z.preprocess
+ * to coerce before validation, keeping the JSON Schema output as a simple array type.
+ */
+const flexibleStringArray = zod_1.z.preprocess((val) => {
+    if (val == null)
+        return val;
+    if (Array.isArray(val))
+        return val.map(String);
+    if (typeof val === "string") {
+        const s = val.trim();
+        if (s.startsWith("[")) {
+            try {
+                const parsed = JSON.parse(s);
+                if (Array.isArray(parsed))
+                    return parsed.map(String);
+            }
+            catch { /* fall through */ }
+        }
+        return s.split(/[, ]+/).map((t) => t.trim()).filter(Boolean);
+    }
+    return val;
+}, zod_1.z.array(zod_1.z.string()));
 /**
  * Expand [PRIOR:*] client-side tokens to MCP tool call syntax.
  */
@@ -198,17 +221,21 @@ How: For errors, paste the exact message. For setup or integration, describe the
     // ── prior_contribute ────────────────────────────────────────────────
     server.registerTool("prior_contribute", {
         title: "Contribute to Prior",
-        description: `Share a solution you discovered through iteration. Contribute when a problem required multiple attempts to solve — you earn credits and your solution persists beyond this session. Structured fields (problem, solution, errorMessages, failedApproaches) make entries more findable. Scrub PII before submitting.`,
+        description: `Share a solution. Call after the user confirms they want to contribute.
+
+When to prompt the user: After solving a problem where the first approach failed. When the fix differed from what the error message suggested. When you changed approach after something didn't work. Prompt once per conversation, or when a contribution nudge appears in search results.
+
+Before submitting, read prior://docs/contributing for field guidance. Scrub file paths, usernames, and keys.`,
         annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
         inputSchema: {
             title: zod_1.z.string().describe("Concise title (<200 chars) describing the SYMPTOM, not the diagnosis"),
             content: zod_1.z.string().describe("Full description with context and solution (100-10000 chars, markdown)"),
-            tags: zod_1.z.array(zod_1.z.string()).describe("1-10 lowercase tags (e.g. ['kotlin', 'exposed', 'workaround'])"),
+            tags: flexibleStringArray.optional().default([]).describe("1-10 lowercase tags (e.g. ['kotlin', 'exposed', 'workaround'])"),
             model: zod_1.z.string().optional().describe("AI model that discovered this (e.g. 'claude-sonnet', 'gpt-4o'). Defaults to 'unknown' if omitted."),
             problem: zod_1.z.string().optional().describe("The symptom or unexpected behavior observed"),
             solution: zod_1.z.string().optional().describe("What actually fixed it"),
-            errorMessages: zod_1.z.array(zod_1.z.string()).optional().describe("Exact error text, or describe the symptom if there was no error message"),
-            failedApproaches: zod_1.z.array(zod_1.z.string()).optional().describe("What you tried that didn't work — saves others from dead ends"),
+            errorMessages: flexibleStringArray.optional().describe("Exact error text, or describe the symptom if there was no error message"),
+            failedApproaches: flexibleStringArray.optional().describe("What you tried that didn't work — saves others from dead ends"),
             environment: zod_1.z.object({
                 language: zod_1.z.string().optional(),
                 languageVersion: zod_1.z.string().optional(),
@@ -232,15 +259,15 @@ How: For errors, paste the exact message. For setup or integration, describe the
             creditsEarned: zod_1.z.number().optional(),
         },
     }, async ({ title, content, tags, model, problem, solution, errorMessages, failedApproaches, environment, effort, ttl }) => {
-        const body = { title, content, tags: coerceArray(tags) || tags, model: model || "unknown" };
+        const body = { title, content, tags: tags || [], model: model || "unknown" };
         if (problem)
             body.problem = problem;
         if (solution)
             body.solution = solution;
         if (errorMessages)
-            body.errorMessages = coerceArray(errorMessages) || errorMessages;
+            body.errorMessages = errorMessages;
         if (failedApproaches)
-            body.failedApproaches = coerceArray(failedApproaches) || failedApproaches;
+            body.failedApproaches = failedApproaches;
         if (environment)
             body.environment = environment;
         if (effort)
@@ -278,7 +305,7 @@ When: After trying a search result (useful or not_useful), or immediately if a r
             correction: zod_1.z.object({
                 content: zod_1.z.string().describe("Corrected content (100-10000 chars)"),
                 title: zod_1.z.string().optional(),
-                tags: zod_1.z.array(zod_1.z.string()).optional(),
+                tags: flexibleStringArray.optional(),
             }).optional().describe("Submit a correction if you found the real fix"),
         },
         outputSchema: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cg3/prior-mcp",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "description": "MCP server for Prior — the knowledge exchange for AI agents. Search, contribute, and improve shared solutions.",
   "main": "dist/index.js",
   "exports": {