@cg3/prior-mcp 0.5.15 → 0.5.17

package/dist/resources.js

@@ -136,9 +136,12 @@ These supplement content — they are not replacements for it:
 **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.
+## Generalizing (Critical)
+Prior is a **public** knowledge base. Write for strangers on unrelated projects, not your team.
+- Replace project-specific class/table/service names with generic equivalents
+- Describe the **pattern**, not your architecture (e.g., "two DB rows shared the same key hash" not "our SubscriptionService left duplicates in the agents table")
+- Test: would a developer on a completely different stack find this useful?
+- If it reads like an internal postmortem, it's too specific — abstract it
 
 ## Effort Tracking
 Include \`effort.tokensUsed\` if you can estimate tokens spent. Helps calculate value saved for others.

package/dist/tools.js

@@ -241,7 +241,9 @@ Feedback: Include previousSearchFeedback to rate a result from your last search
 
 When to prompt the user: After each non-trivial fix — not just at end of conversation. If you fixed something by reasoning rather than a known solution, ask inline: "That took some debugging — want me to contribute this to Prior?" Also prompt when the fix differed from what the error suggested, or when a contribution nudge appears in search results.
 
-Before submitting, read prior://docs/contributing for field guidance. Scrub file paths, usernames, and keys.`,
+Before submitting, read prior://docs/contributing for field guidance. Scrub PII and project-specific details — Prior is a public knowledge base. Write for developers on unrelated projects, not your team.
+
+If the response has requiresConfirmation=true, Prior found similar entries that may already cover this topic. Review them — if they solve the problem, don't re-contribute. If your contribution adds unique value (different environment, additional context, better solution), call prior_contribute again with the same fields plus the confirmToken from the response.`,
         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"),
@@ -268,14 +270,19 @@ Before submitting, read prior://docs/contributing for field guidance. Scrub file
                 toolCalls: zod_1.z.number().optional(),
             }).optional().describe("Effort spent discovering this solution"),
             ttl: zod_1.z.string().optional().describe("Time to live: 30d, 60d, 90d (default), 365d, evergreen"),
+            confirmToken: zod_1.z.string().optional().describe("Token from a previous near-duplicate response. Include this to confirm your contribution adds unique value despite similar entries existing."),
         },
         outputSchema: {
-            id: zod_1.z.string().describe("Short ID of the new entry"),
-            status: zod_1.z.string().describe("Entry status (active or pending)"),
+            id: zod_1.z.string().describe("Short ID of the new entry (empty if requiresConfirmation)"),
+            status: zod_1.z.string().describe("Entry status: active, pending, or near_duplicate"),
             creditsEarned: zod_1.z.number().optional(),
+            requiresConfirmation: zod_1.z.boolean().optional().describe("If true, similar entries exist. Review them and re-submit with confirmToken."),
+            confirmToken: zod_1.z.string().optional().describe("Token to include in re-submission to confirm contribution"),
         },
-    }, async ({ title, content, tags, model, problem, solution, errorMessages, failedApproaches, environment, effort, ttl }) => {
+    }, async ({ title, content, tags, model, problem, solution, errorMessages, failedApproaches, environment, effort, ttl, confirmToken }) => {
         const body = { title, content, tags: tags || [], model: model || "unknown" };
+        if (confirmToken)
+            body.confirmToken = confirmToken;
         if (problem)
             body.problem = problem;
         if (solution)
@@ -292,6 +299,20 @@ Before submitting, read prior://docs/contributing for field guidance. Scrub file
             body.ttl = ttl;
         const data = await client.request("POST", "/v1/knowledge/contribute", body);
         const entry = data?.data || data;
+        // Handle near-duplicate soft band response
+        if (entry?.requiresConfirmation || entry?.status === "near_duplicate") {
+            const dupes = entry.nearDuplicates || [];
+            const dupeList = dupes.map((d) => `  - ${d.shortId}: "${d.title}" (${Math.round(d.similarity * 100)}% similar)`).join("\n");
+            return {
+                structuredContent: {
+                    id: "",
+                    status: "near_duplicate",
+                    requiresConfirmation: true,
+                    confirmToken: entry.confirmToken,
+                },
+                content: [{ type: "text", text: `Similar entries already exist in Prior:\n${dupeList}\n\nReview these entries — if they already solve the problem, no need to contribute. If your contribution adds unique value, call prior_contribute again with the same fields plus confirmToken: "${entry.confirmToken}"` }],
+            };
+        }
         return {
             structuredContent: {
                 id: entry?.id || entry?.shortId || "",
@@ -328,6 +349,7 @@ When: After trying a search result (useful or not_useful), or immediately if a r
             ok: zod_1.z.boolean(),
             creditsRefunded: zod_1.z.number().describe("Credits refunded for this feedback"),
             previousOutcome: zod_1.z.string().nullable().optional().describe("Previous outcome if updating existing feedback"),
+            message: zod_1.z.string().optional().describe("Feedback result message (e.g. skip reason)"),
         },
     }, async ({ entryId, outcome, reason, notes, correctionId, correction }) => {
         const body = { outcome };
@@ -341,11 +363,13 @@ When: After trying a search result (useful or not_useful), or immediately if a r
             body.correction = correction;
         const data = await client.request("POST", `/v1/knowledge/${entryId}/feedback`, body);
         const result = data?.data || data;
+        const rewardMessage = result?.reward?.message || result?.message;
         return {
             structuredContent: {
                 ok: data?.ok ?? true,
                 creditsRefunded: result?.reward?.creditsRefunded || result?.creditsRefunded || result?.creditRefund || 0,
                 previousOutcome: result?.previousOutcome,
+                ...(rewardMessage ? { message: rewardMessage } : {}),
             },
             content: [{ type: "text", text: (0, utils_js_1.formatResults)(data) }],
         };

package/package.json

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