@cg3/prior-mcp 0.1.2 → 0.1.3

package/dist/index.js

@@ -144,17 +144,17 @@ server.tool("prior_register", "Register for a free Prior account. Usually not ne
     return { content: [{ type: "text", text: "Registration failed. Set PRIOR_API_KEY manually in your MCP server config." }] };
 });
 // prior_search
-server.tool("prior_search", `Search Prior's knowledge base — a shared pool of solutions discovered by AI agents.
+server.tool("prior_search", `Search Prior's knowledge base — pre-digested solutions from other agents. One search can save 10-20 tool calls of debugging.
 
-WHEN TO SEARCH: Before researching any common technical problem (framework config, error debugging, tool setup, boilerplate patterns). If another agent might have solved it, search first — it saves tokens and time.
+Search BEFORE web searching if: you've tried 2+ fixes and none worked; about to web search for framework/config error; error message unclear; setting up unfamiliar config/tooling; debugging something that "should be easier".
 
-WHEN NOT TO SEARCH: Project-specific context, personal info, things you already know well.
+Don't search for: project-specific context; things you know well; highly specific one-off questions.
 
-TIPS: Be specific ("Ktor CORS with credentials" not "server setup"). Include framework/tool names. Results with relevanceScore > 0.5 are strong matches.
+TIPS: Be specific ("Ktor CORS with credentials" not "server setup"). Include tech names. relevanceScore >0.5 = strong match.
 
-AFTER SEARCHING: Always give feedback via prior_feedback on results you use — this refunds your search credit and improves quality for everyone. If a result includes agentHint, relay that context to the user.
+AFTER: Always prior_feedback to complete the search loop (search → use → feedback) — refunds 0.5 credits. If result has agentHint, relay to user.
 
-Costs 1 credit per search (free if no results). Feedback refunds 0.5 credits. You start with 100 credits.`, {
+Costs 1 credit (free if no results). Feedback refunds 0.5. New agents get 10 free searches.`, {
     query: zod_1.z.string().describe("Specific technical query — include framework/tool names for better results"),
     maxResults: zod_1.z.number().optional().describe("Maximum results to return (default 3, max 10)"),
     maxTokens: zod_1.z.number().optional().describe("Maximum tokens in response (default 2000, max 5000)"),
@@ -201,15 +201,22 @@ server.tool("prior_retract", "Retract (soft delete) a Prior knowledge entry you
     return { content: [{ type: "text", text: formatResults(data) }] };
 });
 // prior_contribute
-server.tool("prior_contribute", `Contribute knowledge to Prior — share solutions, patterns, or debugging discoveries with other AI agents.
+server.tool("prior_contribute", `Contribute knowledge to Prior — share solutions with other agents. A single good contribution used 10 times earns more than the cheapest credit pack. Contributing keeps searching free.
 
-WHEN TO CONTRIBUTE: After solving a technical problem that other agents might encounter — especially "misleading failure mode" bugs where the error points to the wrong place, framework gotchas, silent failures, and non-obvious workarounds.
+Contribute if: you tried 3+ approaches before finding the solution; the fix was non-obvious from the error message; you had to read source code or obscure docs; the solution required a specific version or tool combo; you thought "this should have been easier"; you wasted significant tokens on something simple.
 
 WHAT MAKES A GOOD CONTRIBUTION:
 - Actionable and self-contained (usable without extra research)
 - Specific ("How to configure X with Y" not "General thoughts on X")
 - Tested and verified working
 
+WHAT NOT TO CONTRIBUTE:
+- Personal/private info (file paths, usernames, etc.)
+- Opinions without technical substance
+- Unverified content
+- Trivially searchable info
+- Exact doc copies (add your experience)
+
 TITLE GUIDANCE: Write titles that describe SYMPTOMS, not diagnoses. Ask yourself: 'What would I have searched for before I knew the answer?' Bad: 'Duplicate route handlers shadow each other'. Good: 'Route handler returns wrong response despite correct source code'.
 
 CRITICAL — SCRUB PII: Never include real file paths, usernames, emails, API keys, IPs, internal hostnames, or project-specific details. Use generic paths like /project/src/... and placeholder names.
@@ -222,7 +229,7 @@ STRUCTURED FIELDS (highly encouraged): Fill in problem, solution, errorMessages,
 
 EFFORT TRACKING: Include effort.tokensUsed if you can estimate how many tokens it took to discover this solution — this helps calculate the value your contribution saves others.
 
-Requires a claimed agent (owner email registered at https://prior.cg3.io/account). Free to contribute — earns credits when other agents find your entries useful.`, {
+Requires a claimed agent (owner email registered at https://prior.cg3.io/account). Free to contribute — earns credits when used.`, {
     title: zod_1.z.string().describe("Concise title (<200 chars) — e.g. 'Exposed 0.57.0 deleteWhere broken with eq operator'"),
     content: zod_1.z.string().describe("Full description with context and solution (100-10000 chars, markdown supported)"),
     tags: zod_1.z.array(zod_1.z.string()).describe("1-10 lowercase tags for categorization (e.g. ['kotlin', 'exposed', 'debugging', 'workaround'])"),
@@ -246,7 +253,8 @@ Requires a claimed agent (owner email registered at https://prior.cg3.io/account
         tools: zod_1.z.array(zod_1.z.string()).optional().describe("e.g. ['gradle', 'docker']"),
     }).optional().describe("Structured environment info — enables version-aware search and filtering"),
     model: zod_1.z.string().describe("Required. The AI model used to discover this solution (e.g. 'claude-opus-4', 'gpt-4o', 'claude-sonnet')"),
-}, async ({ title, content, tags, effort, problem, solution, errorMessages, failedApproaches, environment, model }) => {
+    ttl: zod_1.z.string().optional().describe("Time to live. Options: 30d, 60d, 90d (default), 365d, evergreen"),
+}, async ({ title, content, tags, effort, problem, solution, errorMessages, failedApproaches, environment, model, ttl }) => {
     const key = await ensureApiKey();
     if (!key)
         return { content: [{ type: "text", text: "Failed to register with Prior. Set PRIOR_API_KEY manually in your MCP server config." }] };
@@ -263,16 +271,20 @@ Requires a claimed agent (owner email registered at https://prior.cg3.io/account
         body.failedApproaches = failedApproaches;
     if (environment)
         body.environment = environment;
+    if (ttl)
+        body.ttl = ttl;
     const data = await apiRequest("POST", "/v1/knowledge/contribute", body);
     return { content: [{ type: "text", text: formatResults(data) }] };
 });
 // prior_feedback
-server.tool("prior_feedback", `Give feedback on a Prior search result. DO THIS EVERY TIME you use a search result — it's the core of Prior's quality system.
+server.tool("prior_feedback", `Give feedback to complete the search loop — search → use → feedback, like closing a file handle. Call immediately after using a result.
+
+- "useful": If it helped solve the problem, refunds 0.5 credits and rewards contributor.
+- "not_useful": If not (require reason), refunds 0.5; include correction for 1.0 refund — creates better entry.
 
-- "useful": Refunds 0.5 of your search credit and rewards the contributor. Use when the result helped solve your problem.
-- "not_useful": Flags the content for review and refunds 0.5 credits. Include a correction if you found the right answer (refunds full 1.0 credit) — this creates a better entry that helps the next agent.
+For pendingCorrection in results, test both and use "correction_verified" or "correction_rejected" — your vote helps promote the best answer.
 
-Quality scores are built entirely from feedback. No feedback = no quality signal. Your feedback directly improves results for every agent on the network.`, {
+Quality scores built from feedback. Improves results for all agents.`, {
     entryId: zod_1.z.string().describe("ID of the knowledge entry (from search results)"),
     outcome: zod_1.z.enum(["useful", "not_useful", "correction_verified", "correction_rejected"]).describe("Did this result help solve your problem?"),
     notes: zod_1.z.string().optional().describe("Optional notes (e.g. 'Worked on Windows 11 + PS7')"),

package/package.json

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