coding-friend-cli 1.0.0

package/lib/learn-mcp/src/tools/track-knowledge.ts

@@ -0,0 +1,35 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { trackKnowledge } from "../lib/knowledge.js";
+
+export function registerTrackKnowledge(
+  server: McpServer,
+  docsDir: string,
+): void {
+  server.tool(
+    "track-knowledge",
+    "Record the user's self-assessment of their understanding of a specific learning doc. Status: 'remembered', 'needs-review', or 'new'.",
+    {
+      category: z.string().describe("Category folder name"),
+      slug: z.string().describe("Doc filename without .md extension"),
+      status: z
+        .enum(["remembered", "needs-review", "new"])
+        .describe("User's self-assessment of knowledge retention"),
+      notes: z
+        .string()
+        .optional()
+        .describe("Optional notes about understanding level"),
+    },
+    async ({ category, slug, status, notes }) => {
+      const entry = trackKnowledge(docsDir, category, slug, status, notes);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({ tracked: true, entry }, null, 2),
+          },
+        ],
+      };
+    },
+  );
+}

package/lib/learn-mcp/src/tools/update-doc.ts

@@ -0,0 +1,43 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { updateDoc } from "../lib/docs.js";
+
+export function registerUpdateDoc(server: McpServer, docsDir: string): void {
+  server.tool(
+    "update-doc",
+    "Update an existing learning doc. Can append content, add tags, or update the title. Content is appended (not replaced).",
+    {
+      category: z.string().describe("Category folder name"),
+      slug: z.string().describe("Doc filename without .md extension"),
+      content: z.string().optional().describe("Markdown content to append"),
+      tags: z
+        .array(z.string())
+        .optional()
+        .describe("Tags to add (merged with existing)"),
+      title: z.string().optional().describe("New title"),
+    },
+    async ({ category, slug, content, tags, title }) => {
+      const filePath = updateDoc(docsDir, category, slug, {
+        content,
+        tags,
+        title,
+      });
+      if (!filePath) {
+        return {
+          content: [
+            { type: "text", text: `Doc not found: ${category}/${slug}.md` },
+          ],
+          isError: true,
+        };
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({ path: filePath, updated: true }, null, 2),
+          },
+        ],
+      };
+    },
+  );
+}

package/lib/learn-mcp/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "coding-friend-cli",
+  "version": "1.0.0",
+  "description": "CLI for coding-friend — host learning docs, setup MCP server, initialize projects",
+  "type": "module",
+  "bin": {
+    "cf": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/postinstall.ts --format esm --dts --clean",
+    "postinstall": "node dist/postinstall.js || true",
+    "prepublishOnly": "npm run build && node scripts/bundle-libs.js",
+    "dev": "tsx src/index.ts"
+  },
+  "files": [
+    "dist",
+    "lib"
+  ],
+  "keywords": [
+    "coding-friend",
+    "cli",
+    "learning",
+    "mcp",
+    "claude"
+  ],
+  "author": "Anh-Thi Dinh",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dinhanhthi/coding-friend.git",
+    "directory": "cli"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.0.0",
+    "commander": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0"
+  }
+}