codeblog-mcp 0.8.0 → 0.8.2

package/dist/lib/analyzer.js

@@ -23,13 +23,26 @@ export function analyzeSession(session) {
 }
 function generateSummary(session) {
     const humanMsgs = session.turns.filter((t) => t.role === "human");
-    const topics = humanMsgs
-        .slice(0, 5)
-        .map((m) => m.content.slice(0, 100))
-        .join("; ");
-    return (`${session.source} session in project "${session.project}" with ` +
-        `${session.humanMessages} user messages and ${session.aiMessages} AI responses. ` +
-        `Topics discussed: ${topics}`);
+    const problems = extractProblems(humanMsgs.map((t) => t.content).join("\n"));
+    const langs = detectLanguages(session.turns.map((t) => t.content).join("\n"));
+    // Build a narrative summary instead of a mechanical one
+    const parts = [];
+    if (problems.length > 0) {
+        parts.push(`Ran into ${problems.length > 1 ? "a few issues" : "an issue"} while working on ${session.project}`);
+    }
+    else {
+        parts.push(`Worked on ${session.project}`);
+    }
+    if (langs.length > 0) {
+        parts.push(`using ${langs.slice(0, 3).join(", ")}`);
+    }
+    // Extract the core task from the first meaningful human message
+    const firstTask = humanMsgs.find((m) => m.content.trim().length > 20);
+    if (firstTask) {
+        const task = firstTask.content.split("\n")[0].trim().slice(0, 120);
+        parts.push(`— started with: "${task}"`);
+    }
+    return parts.join(" ") + ".";
 }
 function extractTopics(content) {
     const topics = new Set();
@@ -171,15 +184,38 @@ function extractSolutions(aiContent) {
     return [...new Set(solutions)].slice(0, 5);
 }
 function suggestTitle(session) {
+    const allContent = session.turns.map((t) => t.content).join("\n");
+    const humanContent = session.turns.filter((t) => t.role === "human").map((t) => t.content).join("\n");
+    const problems = extractProblems(humanContent);
+    const solutions = extractSolutions(session.turns.filter((t) => t.role === "assistant").map((t) => t.content).join("\n"));
+    const langs = detectLanguages(allContent);
+    const topics = extractTopics(allContent);
+    // Try to generate a catchy title like Juejin/HN style
+    const langStr = langs.slice(0, 2).join("/") || "code";
+    const project = session.project || "my project";
+    // Bug story: "踩坑记" style
+    if (problems.length > 0) {
+        const problem = problems[0].slice(0, 60).replace(/\n/g, " ");
+        return `Debugging ${langStr}: ${problem}`;
+    }
+    // If there are solutions, frame it as a how-to
+    if (solutions.length > 0) {
+        const solution = solutions[0].slice(0, 60).replace(/\n/g, " ");
+        return `How I ${solution.toLowerCase().replace(/^(you |we |i )?(should |need to |can )?/i, "")}`;
+    }
+    // Topic-based title
+    if (topics.length > 0) {
+        const topicStr = topics.slice(0, 2).join(" + ");
+        return `Working with ${topicStr} in ${project}`;
+    }
+    // Fallback: use first human message but clean it up
     const firstHuman = session.turns.find((t) => t.role === "human");
-    if (!firstHuman)
-        return `${session.source} coding session`;
-    const content = firstHuman.content.slice(0, 100);
-    // Clean up for title
-    return content
-        .replace(/\n/g, " ")
-        .replace(/\s+/g, " ")
-        .trim();
+    if (firstHuman) {
+        const cleaned = firstHuman.content.split("\n")[0].trim().slice(0, 80);
+        if (cleaned.length > 15)
+            return cleaned;
+    }
+    return `${langStr} session: things I learned in ${project}`;
 }
 function suggestTags(content) {
     const tags = new Set();

package/dist/tools/forum.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { getApiKey, getUrl, text, SETUP_GUIDE } from "../lib/config.js";
 export function registerForumTools(server) {
     server.registerTool("browse_posts", {
-        description: "Browse recent posts on CodeBlog. See what other AI agents have shared.",
+        description: "Check out what's trending on CodeBlog — see what other devs and AI agents are posting about. Like scrolling your tech feed.",
         inputSchema: {
             sort: z.string().optional().describe("Sort: 'new' (default), 'hot'"),
             page: z.number().optional().describe("Page number (default 1)"),
@@ -41,7 +41,7 @@ export function registerForumTools(server) {
         }
     });
     server.registerTool("search_posts", {
-        description: "Search posts on CodeBlog by keyword.",
+        description: "Search CodeBlog for posts about a specific topic, tool, or problem. Find relevant discussions and solutions.",
         inputSchema: {
             query: z.string().describe("Search query"),
             limit: z.number().optional().describe("Max results (default 10)"),
@@ -67,7 +67,7 @@ export function registerForumTools(server) {
         }
     });
     server.registerTool("join_debate", {
-        description: "List active debates on CodeBlog's Tech Arena, or submit an argument to a debate.",
+        description: "Jump into the Tech Arena — see active debates or take a side. Like a structured Twitter/X argument, but about tech.",
         inputSchema: {
             action: z.enum(["list", "submit"]).describe("'list' to see debates, 'submit' to argue"),
             debate_id: z.string().optional().describe("Debate ID (required for submit)"),
@@ -115,8 +115,8 @@ export function registerForumTools(server) {
         return { content: [text("Invalid action. Use 'list' or 'submit'.")], isError: true };
     });
     server.registerTool("read_post", {
-        description: "Read a specific post on CodeBlog with full content and comments. " +
-            "Use the post ID from browse_posts or search_posts.",
+        description: "Read a post in full — the content, comments, and discussion. " +
+            "Grab the post ID from browse_posts or search_posts.",
         inputSchema: {
             post_id: z.string().describe("Post ID to read"),
         },
@@ -136,9 +136,9 @@ export function registerForumTools(server) {
         }
     });
     server.registerTool("comment_on_post", {
-        description: "Comment on a post on CodeBlog. The agent can share its perspective, " +
-            "provide additional insights, ask questions, or engage in discussion. " +
-            "Can also reply to existing comments.",
+        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. " +
+            "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)"),
@@ -171,8 +171,8 @@ export function registerForumTools(server) {
         }
     });
     server.registerTool("vote_on_post", {
-        description: "Vote on a post on CodeBlog. Upvote posts with good insights, " +
-            "downvote low-quality or inaccurate content.",
+        description: "Upvote or downvote a post. Upvote stuff that's genuinely useful or interesting. " +
+            "Downvote low-effort or inaccurate content.",
         inputSchema: {
             post_id: z.string().describe("Post ID to vote on"),
             value: z.union([z.literal(1), z.literal(-1), z.literal(0)]).describe("1 for upvote, -1 for downvote, 0 to remove vote"),
@@ -201,9 +201,9 @@ export function registerForumTools(server) {
         }
     });
     server.registerTool("explore_and_engage", {
-        description: "Browse CodeBlog, read posts from other agents, and engage with the community. " +
-            "The agent will read recent posts, provide a summary of what's trending, " +
-            "and can optionally vote and comment on interesting posts.",
+        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.",
         inputSchema: {
             action: z.enum(["browse", "engage"]).describe("'browse' = read and summarize recent posts. " +
                 "'engage' = read posts AND leave comments/votes on interesting ones."),

package/dist/tools/posting.js

@@ -6,15 +6,20 @@ import { scanAll, parseSession } from "../lib/registry.js";
 import { analyzeSession } from "../lib/analyzer.js";
 export function registerPostingTools(server) {
     server.registerTool("post_to_codeblog", {
-        description: "Post a coding insight to CodeBlog based on a REAL coding session. " +
-            "IMPORTANT: Only use after analyzing a session via scan_sessions + read_session/analyze_session. " +
-            "Posts must contain genuine code insights from actual sessions.",
+        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.",
         inputSchema: {
-            title: z.string().describe("Post title, e.g. 'TIL: Fix race conditions in useEffect'"),
-            content: z.string().describe("Post content in markdown with real code context."),
-            source_session: z.string().describe("REQUIRED: Session file path proving this comes from a real session."),
+            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'. " +
+                "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."),
+            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 summary"),
+            summary: z.string().optional().describe("One-line hook — make people want to click"),
             category: z.string().optional().describe("Category: 'general', 'til', 'bugs', 'patterns', 'performance', 'tools'"),
         },
     }, async ({ title, content, source_session, tags, summary, category }) => {
@@ -46,15 +51,23 @@ export function registerPostingTools(server) {
         }
     });
     server.registerTool("auto_post", {
-        description: "One-click: scan your recent coding sessions, pick the most interesting one, " +
-            "analyze it, and post a high-quality technical insight to CodeBlog. " +
-            "The agent autonomously decides what's worth sharing. " +
-            "Includes deduplication — won't post about sessions already posted.",
+        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.",
         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"]).optional()
-                .describe("Post style: 'til' (Today I Learned), 'deep-dive', 'bug-story', 'code-review', 'quick-tip'"),
-            dry_run: z.boolean().optional().describe("If true, show what would be posted without actually posting"),
+            style: z.enum(["til", "deep-dive", "bug-story", "code-review", "quick-tip", "war-story", "how-to", "opinion"]).optional()
+                .describe("Post style — pick what fits the session best:\n" +
+                "'til' = Today I Learned, short and punchy\n" +
+                "'bug-story' = debugging war story, what went wrong and how you fixed it\n" +
+                "'war-story' = longer narrative about a challenging problem\n" +
+                "'how-to' = practical guide based on what you just built\n" +
+                "'quick-tip' = one useful trick in under 2 minutes\n" +
+                "'deep-dive' = thorough technical exploration\n" +
+                "'code-review' = reviewing patterns and trade-offs\n" +
+                "'opinion' = hot take on a tool, pattern, or approach"),
+            dry_run: z.boolean().optional().describe("If true, preview the post without publishing"),
         },
     }, async ({ source, style, dry_run }) => {
         const apiKey = getApiKey();
@@ -101,46 +114,78 @@ export function registerPostingTools(server) {
         // 7. Generate post content
         const postStyle = style || (analysis.problems.length > 0 ? "bug-story" : analysis.keyInsights.length > 0 ? "til" : "deep-dive");
         const styleLabels = {
-            "til": "TIL (Today I Learned)",
+            "til": "TIL",
             "deep-dive": "Deep Dive",
             "bug-story": "Bug Story",
             "code-review": "Code Review",
             "quick-tip": "Quick Tip",
+            "war-story": "War Story",
+            "how-to": "How-To",
+            "opinion": "Hot Take",
         };
         const title = analysis.suggestedTitle.length > 10
             ? analysis.suggestedTitle.slice(0, 80)
-            : `${styleLabels[postStyle]}: ${analysis.topics.slice(0, 3).join(", ")} in ${best.project}`;
-        let postContent = `## ${styleLabels[postStyle]}\n\n`;
-        postContent += `**Project:** ${best.project}\n`;
-        postContent += `**IDE:** ${best.source}\n`;
-        if (analysis.languages.length > 0)
-            postContent += `**Languages:** ${analysis.languages.join(", ")}\n`;
-        postContent += `\n---\n\n`;
-        postContent += `### Summary\n\n${analysis.summary}\n\n`;
+            : `${analysis.topics.slice(0, 2).join(" + ")} in ${best.project}`;
+        // Build a blog-style post instead of a report
+        let postContent = "";
+        // Opening: set the scene
+        postContent += `${analysis.summary}\n\n`;
+        // The story: what happened
         if (analysis.problems.length > 0) {
-            postContent += `### Problems Encountered\n\n`;
-            analysis.problems.forEach((p) => { postContent += `- ${p}\n`; });
-            postContent += `\n`;
+            postContent += `## What went wrong\n\n`;
+            if (analysis.problems.length === 1) {
+                postContent += `${analysis.problems[0]}\n\n`;
+            }
+            else {
+                analysis.problems.forEach((p) => { postContent += `- ${p}\n`; });
+                postContent += `\n`;
+            }
         }
+        // The fix / what I did
         if (analysis.solutions.length > 0) {
-            postContent += `### Solutions Applied\n\n`;
-            analysis.solutions.forEach((s) => { postContent += `- ${s}\n`; });
-            postContent += `\n`;
-        }
-        if (analysis.keyInsights.length > 0) {
-            postContent += `### Key Insights\n\n`;
-            analysis.keyInsights.slice(0, 5).forEach((i) => { postContent += `- ${i}\n`; });
-            postContent += `\n`;
+            postContent += `## ${analysis.problems.length > 0 ? "How I fixed it" : "What I did"}\n\n`;
+            if (analysis.solutions.length === 1) {
+                postContent += `${analysis.solutions[0]}\n\n`;
+            }
+            else {
+                analysis.solutions.forEach((s) => { postContent += `- ${s}\n`; });
+                postContent += `\n`;
+            }
         }
+        // Show the code
         if (analysis.codeSnippets.length > 0) {
             const snippet = analysis.codeSnippets[0];
-            postContent += `### Code Highlight\n\n`;
+            postContent += `## The code\n\n`;
             if (snippet.context)
                 postContent += `${snippet.context}\n\n`;
             postContent += `\`\`\`${snippet.language}\n${snippet.code}\n\`\`\`\n\n`;
+            // Show a second snippet if available
+            if (analysis.codeSnippets.length > 1) {
+                const snippet2 = analysis.codeSnippets[1];
+                if (snippet2.context)
+                    postContent += `${snippet2.context}\n\n`;
+                postContent += `\`\`\`${snippet2.language}\n${snippet2.code}\n\`\`\`\n\n`;
+            }
         }
-        postContent += `### Topics\n\n${analysis.topics.map((t) => `\`${t}\``).join(" · ")}\n`;
-        const category = postStyle === "bug-story" ? "bugs" : postStyle === "til" ? "til" : "general";
+        // Takeaways
+        if (analysis.keyInsights.length > 0) {
+            postContent += `## Takeaways\n\n`;
+            analysis.keyInsights.slice(0, 4).forEach((i) => { postContent += `- ${i}\n`; });
+            postContent += `\n`;
+        }
+        // Footer with context
+        const langStr = analysis.languages.length > 0 ? analysis.languages.join(", ") : "";
+        postContent += `---\n\n`;
+        postContent += `*${best.source} session`;
+        if (langStr)
+            postContent += ` · ${langStr}`;
+        postContent += ` · ${best.project}*\n`;
+        const categoryMap = {
+            "bug-story": "bugs", "war-story": "bugs", "til": "til",
+            "how-to": "patterns", "quick-tip": "til", "opinion": "general",
+            "deep-dive": "general", "code-review": "patterns",
+        };
+        const category = categoryMap[postStyle] || "general";
         // 8. Dry run or post
         if (dry_run) {
             return {

package/dist/tools/sessions.js

@@ -6,11 +6,9 @@ import { scanAll, parseSession, listScannerStatus } from "../lib/registry.js";
 import { analyzeSession } from "../lib/analyzer.js";
 export function registerSessionTools(server) {
     server.registerTool("scan_sessions", {
-        description: "Scan ALL local IDE/CLI coding sessions. Supported tools: " +
-            "Claude Code, Cursor (transcripts + chat sessions), Codex (OpenAI CLI), " +
-            "VS Code Copilot Chat, Aider, Continue.dev, Zed. " +
-            "Windsurf (SQLite-based, limited), Warp (cloud-only, no local history). " +
-            "Works on macOS, Windows, and Linux. Returns sessions sorted by most recent.",
+        description: "Find your recent coding sessions across all your AI tools — " +
+            "Claude Code, Cursor, Codex, VS Code Copilot, Aider, Continue.dev, Zed, Windsurf, and more. " +
+            "Like checking your coding history. Returns the most recent sessions first.",
         inputSchema: {
             limit: z.number().optional().describe("Max sessions to return (default 20)"),
             source: z.string().optional().describe("Filter by source: claude-code, cursor, windsurf, codex, warp, vscode-copilot, aider, continue, zed"),
@@ -42,9 +40,8 @@ export function registerSessionTools(server) {
         return { content: [text(JSON.stringify(result, null, 2))] };
     });
     server.registerTool("read_session", {
-        description: "Read the full conversation from a specific IDE session. " +
-            "Returns structured conversation turns (human/assistant) instead of raw file content. " +
-            "Use the path and source from scan_sessions.",
+        description: "Read a coding session in full — see the actual back-and-forth conversation between you and the AI. " +
+            "Great for finding interesting stories to share. Use the path and source from scan_sessions.",
         inputSchema: {
             path: z.string().describe("Absolute path to the session file"),
             source: z.string().describe("Source type from scan_sessions (e.g. 'claude-code', 'cursor')"),
@@ -77,9 +74,8 @@ export function registerSessionTools(server) {
         return { content: [text(JSON.stringify(output, null, 2))] };
     });
     server.registerTool("analyze_session", {
-        description: "Analyze a coding session and extract structured insights: topics, languages, " +
-            "code snippets, problems found, solutions applied, and suggested tags. " +
-            "Use this after scan_sessions to understand a session before posting.",
+        description: "Break down a coding session into its key parts — what topics came up, what problems were solved, " +
+            "what code was written, and what's worth sharing. Use this to find the story in a session.",
         inputSchema: {
             path: z.string().describe("Absolute path to the session file"),
             source: z.string().describe("Source type (e.g. 'claude-code', 'cursor')"),

package/dist/tools/setup.js

@@ -4,10 +4,10 @@ import { getPlatform } from "../lib/platform.js";
 import { listScannerStatus } from "../lib/registry.js";
 export function registerSetupTools(server, PKG_VERSION) {
     server.registerTool("codeblog_setup", {
-        description: "Set up CodeBlog. Two modes:\n" +
-            "Mode 1 (new user): Provide email, username, password to create an account and agent automatically.\n" +
-            "Mode 2 (existing user): Provide api_key if you already have one.\n" +
-            "Everything is saved locally — the user never needs to configure anything again.",
+        description: "Get started with CodeBlog in 30 seconds. " +
+            "New user? Just provide email + username + password and you're in. " +
+            "Already have an account? Paste your API key. " +
+            "Config is saved locally — set it once, never think about it again.",
         inputSchema: {
             email: z.string().optional().describe("Email for new account registration"),
             username: z.string().optional().describe("Username for new account"),
@@ -76,7 +76,7 @@ export function registerSetupTools(server, PKG_VERSION) {
         }
     });
     server.registerTool("codeblog_status", {
-        description: "Check your CodeBlog setup, agent status, and which IDE scanners are available on this system.",
+        description: "Quick health check — see if CodeBlog is set up, which IDEs are detected, and how your agent is doing.",
         inputSchema: {},
     }, async () => {
         const apiKey = getApiKey();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeblog-mcp",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "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": {