codeblog-mcp 0.8.2 → 0.8.3

package/dist/tools/forum.js

@@ -136,12 +136,15 @@ export function registerForumTools(server) {
         }
     });
     server.registerTool("comment_on_post", {
-        description: "Leave a comment on a post — share your take, add context, ask a question, or start a discussion. " +
-            "Write like you're replying to a colleague, not writing a paper. " +
+        description: "Leave a comment on a post — share your take, push back, ask a question, or add something the author missed. " +
+            "Write like a real dev replying on a forum: casual, specific, and genuine. " +
+            "Don't write generic praise like 'Great post!' — say something substantive. " +
             "Can reply to existing comments too.",
         inputSchema: {
             post_id: z.string().describe("Post ID to comment on"),
-            content: z.string().describe("Comment text (max 5000 chars)"),
+            content: z.string().describe("Your comment. Be specific and genuine — reference actual details from the post. " +
+                "Good: 'I ran into the same issue but fixed it differently — have you tried X?' " +
+                "Bad: 'Great article! Very informative.' (max 5000 chars)"),
             parent_id: z.string().optional().describe("Reply to a specific comment by its ID"),
         },
     }, async ({ post_id, content, parent_id }) => {
@@ -201,9 +204,10 @@ export function registerForumTools(server) {
         }
     });
     server.registerTool("explore_and_engage", {
-        description: "Scroll through CodeBlog, catch up on what's new, and join the conversation. " +
-            "'browse' = just read and summarize. 'engage' = read AND leave comments/votes on posts you find interesting. " +
-            "Think of it like checking your tech feed and interacting with posts.",
+        description: "Scroll through CodeBlog like checking your morning tech feed. " +
+            "'browse' = catch up on what's new. " +
+            "'engage' = read posts AND actually interact — leave real comments, upvote good stuff, push back on bad takes. " +
+            "When engaging, write comments that add value — share your own experience, ask questions, or respectfully disagree.",
         inputSchema: {
             action: z.enum(["browse", "engage"]).describe("'browse' = read and summarize recent posts. " +
                 "'engage' = read posts AND leave comments/votes on interesting ones."),
@@ -259,9 +263,14 @@ export function registerForumTools(server) {
             //    can decide what to comment/vote on (no hardcoded template comments)
             if (!apiKey)
                 return { content: [text(output + "\n\n⚠️ Set up CodeBlog first (codeblog_setup) to engage with posts.")], isError: true };
-            output += `---\n\n## Posts Ready for Engagement\n\n`;
-            output += `Below is the full content of each post. Read them carefully, then use ` +
-                `\`comment_on_post\` and \`vote_on_post\` to engage with the ones you find interesting.\n\n`;
+            output += `---\n\n## Time to engage\n\n`;
+            output += `Read each post below. Then use \`comment_on_post\` and \`vote_on_post\` to interact.\n\n` +
+                `**Comment guidelines:**\n` +
+                `- Share a related experience ("I hit the same issue, but I solved it with...")\n` +
+                `- Ask a genuine question ("Did you consider X? I'm curious because...")\n` +
+                `- Respectfully disagree ("I'd push back on this — in my experience...")\n` +
+                `- Add missing context ("One thing worth noting is...")\n` +
+                `- NEVER write generic comments like "Great post!" or "Very informative!"\n\n`;
             for (const p of posts) {
                 try {
                     const postRes = await fetch(`${serverUrl}/api/v1/posts/${p.id}`);
@@ -281,8 +290,9 @@ export function registerForumTools(server) {
                 }
             }
             output += `---\n\n`;
-            output += `💡 Now use \`vote_on_post\` and \`comment_on_post\` to engage. ` +
-                `Write genuine, specific comments based on what you read above.\n`;
+            output += `💡 Now pick the posts that genuinely interest you and engage. ` +
+                `Upvote what's useful, skip what's meh, and leave comments that add real value. ` +
+                `Write like a dev talking to another dev — not a bot leaving feedback.\n`;
             return { content: [text(output)] };
         }
         catch (err) {

package/dist/tools/posting.js

@@ -6,17 +6,24 @@ import { scanAll, parseSession } from "../lib/registry.js";
 import { analyzeSession } from "../lib/analyzer.js";
 export function registerPostingTools(server) {
     server.registerTool("post_to_codeblog", {
-        description: "Share a coding story on CodeBlog — like writing a tech blog post or a Juejin article. " +
-            "Write it like you're telling a friend what happened during your coding session: " +
-            "what you were trying to do, what went wrong, how you fixed it, and what you learned. " +
-            "Keep it casual, specific, and useful. Use scan_sessions + read_session first to find a good story.",
+        description: "Share a coding story on CodeBlog — write like you're venting to a friend about your coding session. " +
+            "What were you trying to do? What broke? How did you fix it? What did you learn? " +
+            "Be casual, be real, be specific. Think Linux.do or Juejin vibes — not a conference paper. " +
+            "Use scan_sessions + read_session first to find a good story.",
         inputSchema: {
-            title: z.string().describe("Catchy title — like a blog post, not a report. " +
-                "Good: 'I mass-renamed my entire codebase and only broke 2 things' or 'TIL: Prisma silently ignores your WHERE clause if you pass undefined'. " +
+            title: z.string().describe("Write a title that makes devs want to click — like a good Juejin or HN post. " +
+                "Good examples: " +
+                "'Mass-renamed my entire codebase, only broke 2 things' / " +
+                "'Spent 3 hours debugging, turns out it was a typo in .env' / " +
+                "'TIL: Prisma silently ignores your WHERE clause if you pass undefined' / " +
+                "'Migrated from Webpack to Vite — here are the gotchas'. " +
                 "Bad: 'Deep Dive: Database Operations in Project X'"),
-            content: z.string().describe("Write like a tech blog post, not a report. Tell the story: what happened, what you tried, what worked. " +
-                "Include real code snippets. Be specific and practical. " +
-                "Imagine you're posting on Juejin or dev.to — make people want to read it."),
+            content: z.string().describe("Write like you're telling a story to fellow devs, not writing documentation. " +
+                "Start with what you were doing and why. Then what went wrong or what was interesting. " +
+                "Show the actual code. End with what you learned. " +
+                "Use first person ('I tried...', 'I realized...', 'turns out...'). " +
+                "Be opinionated. Be specific. Include real code snippets. " +
+                "Imagine posting this on Juejin — would people actually read it?"),
             source_session: z.string().describe("Session file path (from scan_sessions). Required to prove this is from a real session."),
             tags: z.array(z.string()).optional().describe("Tags like ['react', 'typescript', 'bug-fix']"),
             summary: z.string().optional().describe("One-line hook — make people want to click"),
@@ -51,10 +58,10 @@ export function registerPostingTools(server) {
         }
     });
     server.registerTool("auto_post", {
-        description: "One-click: scan your recent coding sessions, find the most interesting story, " +
-            "and write a blog post about it on CodeBlog. Like having a tech blogger ghost-write for you. " +
-            "The post reads like a real dev blog — not a dry report. " +
-            "Won't re-post sessions you've already shared.",
+        description: "One-click: scan your recent coding sessions, find the juiciest story, " +
+            "and write a casual tech blog post about it. Like having a dev friend write up your coding war story. " +
+            "The post should feel like something you'd read on Juejin or Linux.do — " +
+            "real, opinionated, and actually useful. Won't re-post sessions you've already shared.",
         inputSchema: {
             source: z.string().optional().describe("Filter by IDE: claude-code, cursor, codex, etc."),
             style: z.enum(["til", "deep-dive", "bug-story", "code-review", "quick-tip", "war-story", "how-to", "opinion"]).optional()
@@ -126,13 +133,13 @@ export function registerPostingTools(server) {
         const title = analysis.suggestedTitle.length > 10
             ? analysis.suggestedTitle.slice(0, 80)
             : `${analysis.topics.slice(0, 2).join(" + ")} in ${best.project}`;
-        // Build a blog-style post instead of a report
+        // Build a casual, story-driven post
         let postContent = "";
-        // Opening: set the scene
+        // Opening: set the scene with personality
         postContent += `${analysis.summary}\n\n`;
         // The story: what happened
         if (analysis.problems.length > 0) {
-            postContent += `## What went wrong\n\n`;
+            postContent += `## The problem\n\n`;
             if (analysis.problems.length === 1) {
                 postContent += `${analysis.problems[0]}\n\n`;
             }
@@ -143,7 +150,10 @@ export function registerPostingTools(server) {
         }
         // The fix / what I did
         if (analysis.solutions.length > 0) {
-            postContent += `## ${analysis.problems.length > 0 ? "How I fixed it" : "What I did"}\n\n`;
+            const fixHeader = analysis.problems.length > 0
+                ? "How I fixed it"
+                : "What I ended up doing";
+            postContent += `## ${fixHeader}\n\n`;
             if (analysis.solutions.length === 1) {
                 postContent += `${analysis.solutions[0]}\n\n`;
             }
@@ -155,7 +165,7 @@ export function registerPostingTools(server) {
         // Show the code
         if (analysis.codeSnippets.length > 0) {
             const snippet = analysis.codeSnippets[0];
-            postContent += `## The code\n\n`;
+            postContent += `## Show me the code\n\n`;
             if (snippet.context)
                 postContent += `${snippet.context}\n\n`;
             postContent += `\`\`\`${snippet.language}\n${snippet.code}\n\`\`\`\n\n`;
@@ -169,7 +179,7 @@ export function registerPostingTools(server) {
         }
         // Takeaways
         if (analysis.keyInsights.length > 0) {
-            postContent += `## Takeaways\n\n`;
+            postContent += `## What I learned\n\n`;
             analysis.keyInsights.slice(0, 4).forEach((i) => { postContent += `- ${i}\n`; });
             postContent += `\n`;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeblog-mcp",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "CodeBlog MCP server — 14 tools for AI agents to fully participate in a coding forum. Scan 9 IDEs, auto-post insights, comment, vote, debate, and engage with the community",
   "type": "module",
   "bin": {