coding-friend-cli 1.2.0 → 1.3.0

package/lib/learn-host/README.md

@@ -0,0 +1,114 @@
+# coding-friend-learn-host
+
+Next.js app that renders your `/cf-learn` docs as a browsable website with search, categories, and dark mode.
+
+## Usage (via CLI)
+
+```bash
+cf host                     # serves docs/learn/ on port 3333
+cf host ./my-docs           # serves a custom directory
+cf host -p 4000             # custom port
+```
+
+The CLI handles deps install, build, and serving automatically.
+
+## Local Development
+
+Run the app directly without the CLI — useful when working on the UI itself.
+
+### 1. Install dependencies
+
+```bash
+cd cli/lib/learn-host
+npm install
+```
+
+### 2. Point to a docs directory
+
+The app resolves docs via (in order):
+
+1. `DOCS_DIR` env var
+2. Local `.coding-friend/config.json` → `learn.outputDir`
+3. Global `~/.coding-friend/config.json` → `learn.outputDir`
+4. Default: `docs/learn/` relative to project root
+
+For local dev, set `DOCS_DIR` to any directory with the expected structure:
+
+```
+docs/
+└── learn/
+    ├── category-one/
+    │   ├── my-doc.md
+    │   └── another-doc.md
+    └── category-two/
+        └── some-doc.md
+```
+
+Each `.md` file should have frontmatter:
+
+```md
+---
+title: My Doc Title
+category: category-one
+tags: [typescript, patterns]
+created: 2025-01-01
+updated: 2025-01-15
+---
+
+Content here...
+```
+
+### 3. Run dev server
+
+```bash
+# Point to this repo's own learn docs (if they exist)
+DOCS_DIR=../../../docs/learn npm run dev
+
+# Or point to any other project's docs
+DOCS_DIR=/path/to/your/project/docs/learn npm run dev
+```
+
+App runs at `http://localhost:3333`.
+
+> **Note:** `npm run dev` does not rebuild the Pagefind search index. If you've previously run `npm run build`, search will still work but uses the old index — new or edited docs won't appear in search results until you build again.
+
+### 4. Full build (with search)
+
+```bash
+DOCS_DIR=/path/to/docs npm run build
+npx next start -p 3333
+```
+
+`postbuild` runs `pagefind` to index docs for full-text search.
+
+## Structure
+
+```
+src/
+├── app/
+│   ├── page.tsx                   # Homepage: recent docs, categories, tags
+│   ├── [category]/page.tsx        # Category listing
+│   ├── [category]/[slug]/page.tsx # Individual doc
+│   └── layout.tsx
+├── components/
+│   ├── MarkdownRenderer.tsx       # Renders .md with syntax highlighting
+│   ├── TableOfContents.tsx        # Auto-generated from headings
+│   ├── Sidebar.tsx                # Category navigation
+│   ├── PagefindSearch.tsx         # Full-text search (build-time index)
+│   └── ThemeToggle.tsx
+└── lib/
+    ├── docs.ts                    # getAllDocs, getDocBySlug, etc.
+    └── types.ts
+```
+
+## How It Fits Together
+
+```
+cf host [path]
+  └─ resolves docs dir
+  └─ npm install (one-time)
+  └─ npm run build  (with DOCS_DIR env)
+  └─ npx next start -p 3333  (with DOCS_DIR env)
+```
+
+ISR (Incremental Static Regeneration) is enabled, so new or edited docs appear on the next page refresh without a rebuild.

package/lib/learn-host/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/lib/learn-host/next.config.ts

@@ -4,6 +4,9 @@ const nextConfig: NextConfig = {
   trailingSlash: true,
   images: { unoptimized: true },
   reactCompiler: true,
+  turbopack: {
+    root: __dirname,
+  },
 };
 
 export default nextConfig;

package/lib/learn-host/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-friend-learn-host",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "private": true,
   "scripts": {
     "dev": "next dev -p 3333",

package/lib/learn-host/public/logo.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" width="512" height="512" x="0" y="0" viewBox="0 0 64 64" style="enable-background:new 0 0 512 512" xml:space="preserve" class=""><g><linearGradient id="a" x1="78.644" x2="25.425" y1="74.123" y2="11.863" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#064e3b"></stop><stop offset="1" stop-color="#10b981"></stop></linearGradient><path fill="url(#a)" fill-rule="evenodd" d="M2 14C2 7.373 7.373 2 14 2h36c6.627 0 12 5.373 12 12v28c0 6.627-5.373 12-12 12H39.908l-6.403 7.317a2 2 0 0 1-3.01 0L24.093 54H14C7.373 54 2 48.627 2 42z" clip-rule="evenodd" opacity="1" data-original="url(#a)" class=""></path><path fill="#ffffff" d="M32 14a2 2 0 0 1 1.95 1.556l1.107 4.867a6 6 0 0 0 4.52 4.52l4.867 1.107a2 2 0 0 1 0 3.9l-4.867 1.107a6 6 0 0 0-4.52 4.52l-1.107 4.866a2 2 0 0 1-3.9 0l-1.107-4.866a6 6 0 0 0-4.52-4.52l-4.866-1.107a2 2 0 0 1 0-3.9l4.866-1.107a6 6 0 0 0 4.52-4.52l1.107-4.866A2 2 0 0 1 32 14z"></path></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" width="512" height="512" x="0" y="0" viewBox="0 0 64 64" style="enable-background:new 0 0 512 512" xml:space="preserve" class=""><g><linearGradient id="a" x1="78.644" x2="25.425" y1="74.123" y2="11.863" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#b45309"></stop><stop offset="1" stop-color="#f59e0b"></stop></linearGradient><path fill="url(#a)" fill-rule="evenodd" d="M2 14C2 7.373 7.373 2 14 2h36c6.627 0 12 5.373 12 12v28c0 6.627-5.373 12-12 12H39.908l-6.403 7.317a2 2 0 0 1-3.01 0L24.093 54H14C7.373 54 2 48.627 2 42z" clip-rule="evenodd" opacity="1" data-original="url(#a)" class=""></path><path fill="#ffffff" d="M32 14a2 2 0 0 1 1.95 1.556l1.107 4.867a6 6 0 0 0 4.52 4.52l4.867 1.107a2 2 0 0 1 0 3.9l-4.867 1.107a6 6 0 0 0-4.52 4.52l-1.107 4.866a2 2 0 0 1-3.9 0l-1.107-4.866a6 6 0 0 0-4.52-4.52l-4.866-1.107a2 2 0 0 1 0-3.9l4.866-1.107a6 6 0 0 0 4.52-4.52l1.107-4.866A2 2 0 0 1 32 14z"></path></g></svg>

package/lib/learn-host/src/app/apple-icon.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" width="512" height="512" x="0" y="0" viewBox="0 0 64 64" style="enable-background:new 0 0 512 512" xml:space="preserve" class=""><g><linearGradient id="a" x1="78.644" x2="25.425" y1="74.123" y2="11.863" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#064e3b"></stop><stop offset="1" stop-color="#10b981"></stop></linearGradient><path fill="url(#a)" fill-rule="evenodd" d="M2 14C2 7.373 7.373 2 14 2h36c6.627 0 12 5.373 12 12v28c0 6.627-5.373 12-12 12H39.908l-6.403 7.317a2 2 0 0 1-3.01 0L24.093 54H14C7.373 54 2 48.627 2 42z" clip-rule="evenodd" opacity="1" data-original="url(#a)" class=""></path><path fill="#ffffff" d="M32 14a2 2 0 0 1 1.95 1.556l1.107 4.867a6 6 0 0 0 4.52 4.52l4.867 1.107a2 2 0 0 1 0 3.9l-4.867 1.107a6 6 0 0 0-4.52 4.52l-1.107 4.866a2 2 0 0 1-3.9 0l-1.107-4.866a6 6 0 0 0-4.52-4.52l-4.866-1.107a2 2 0 0 1 0-3.9l4.866-1.107a6 6 0 0 0 4.52-4.52l1.107-4.866A2 2 0 0 1 32 14z"></path></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" width="512" height="512" x="0" y="0" viewBox="0 0 64 64" style="enable-background:new 0 0 512 512" xml:space="preserve" class=""><g><linearGradient id="a" x1="78.644" x2="25.425" y1="74.123" y2="11.863" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#b45309"></stop><stop offset="1" stop-color="#f59e0b"></stop></linearGradient><path fill="url(#a)" fill-rule="evenodd" d="M2 14C2 7.373 7.373 2 14 2h36c6.627 0 12 5.373 12 12v28c0 6.627-5.373 12-12 12H39.908l-6.403 7.317a2 2 0 0 1-3.01 0L24.093 54H14C7.373 54 2 48.627 2 42z" clip-rule="evenodd" opacity="1" data-original="url(#a)" class=""></path><path fill="#ffffff" d="M32 14a2 2 0 0 1 1.95 1.556l1.107 4.867a6 6 0 0 0 4.52 4.52l4.867 1.107a2 2 0 0 1 0 3.9l-4.867 1.107a6 6 0 0 0-4.52 4.52l-1.107 4.866a2 2 0 0 1-3.9 0l-1.107-4.866a6 6 0 0 0-4.52-4.52l-4.866-1.107a2 2 0 0 1 0-3.9l4.866-1.107a6 6 0 0 0 4.52-4.52l1.107-4.866A2 2 0 0 1 32 14z"></path></g></svg>

package/lib/learn-host/src/app/icon.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" width="512" height="512" x="0" y="0" viewBox="0 0 64 64" style="enable-background:new 0 0 512 512" xml:space="preserve" class=""><g><linearGradient id="a" x1="78.644" x2="25.425" y1="74.123" y2="11.863" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#064e3b"></stop><stop offset="1" stop-color="#10b981"></stop></linearGradient><path fill="url(#a)" fill-rule="evenodd" d="M2 14C2 7.373 7.373 2 14 2h36c6.627 0 12 5.373 12 12v28c0 6.627-5.373 12-12 12H39.908l-6.403 7.317a2 2 0 0 1-3.01 0L24.093 54H14C7.373 54 2 48.627 2 42z" clip-rule="evenodd" opacity="1" data-original="url(#a)" class=""></path><path fill="#ffffff" d="M32 14a2 2 0 0 1 1.95 1.556l1.107 4.867a6 6 0 0 0 4.52 4.52l4.867 1.107a2 2 0 0 1 0 3.9l-4.867 1.107a6 6 0 0 0-4.52 4.52l-1.107 4.866a2 2 0 0 1-3.9 0l-1.107-4.866a6 6 0 0 0-4.52-4.52l-4.866-1.107a2 2 0 0 1 0-3.9l4.866-1.107a6 6 0 0 0 4.52-4.52l1.107-4.866A2 2 0 0 1 32 14z"></path></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" width="512" height="512" x="0" y="0" viewBox="0 0 64 64" style="enable-background:new 0 0 512 512" xml:space="preserve" class=""><g><linearGradient id="a" x1="78.644" x2="25.425" y1="74.123" y2="11.863" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#b45309"></stop><stop offset="1" stop-color="#f59e0b"></stop></linearGradient><path fill="url(#a)" fill-rule="evenodd" d="M2 14C2 7.373 7.373 2 14 2h36c6.627 0 12 5.373 12 12v28c0 6.627-5.373 12-12 12H39.908l-6.403 7.317a2 2 0 0 1-3.01 0L24.093 54H14C7.373 54 2 48.627 2 42z" clip-rule="evenodd" opacity="1" data-original="url(#a)" class=""></path><path fill="#ffffff" d="M32 14a2 2 0 0 1 1.95 1.556l1.107 4.867a6 6 0 0 0 4.52 4.52l4.867 1.107a2 2 0 0 1 0 3.9l-4.867 1.107a6 6 0 0 0-4.52 4.52l-1.107 4.866a2 2 0 0 1-3.9 0l-1.107-4.866a6 6 0 0 0-4.52-4.52l-4.866-1.107a2 2 0 0 1 0-3.9l4.866-1.107a6 6 0 0 0 4.52-4.52l1.107-4.866A2 2 0 0 1 32 14z"></path></g></svg>

package/lib/learn-host/src/components/Sidebar.tsx

@@ -30,7 +30,7 @@ export default function Sidebar({
               }`}
             >
               <span>{cat.name.replace(/[_-]/g, " ")}</span>
-              <span className="dark:bg-navy-800 rounded-full bg-slate-200 px-1.5 py-0.5 text-xs text-slate-500 dark:text-slate-400 border border-slate-200 dark:border-[#a0a0a01c]">
+              <span className="dark:bg-navy-800 rounded-full border border-slate-200 bg-slate-200 px-1.5 py-0.5 text-xs text-slate-500 dark:border-[#a0a0a01c] dark:text-slate-400">
                 {cat.docCount}
               </span>
             </Link>

package/lib/learn-host/src/lib/docs.ts

@@ -53,8 +53,8 @@ function findProjectRoot(from: string): string {
     }
     dir = path.dirname(dir);
   }
-  // Fallback: assume learn-host is at <root>/lib/learn-host
-  return path.resolve(from, "../..");
+  // Fallback: assume learn-host is at <root>/cli/lib/learn-host
+  return path.resolve(from, "../../..");
 }
 
 function resolvePath(p: string, base: string): string {

package/lib/learn-mcp/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog (Learn MCP)
 
+## v0.0.2 (2026-03-01)
+
+- Add support for coding-friend-cli integration
+- Add watch mode for development (`npm run dev`)
+
 ## v0.0.1
 
 - MCP server for LLM integration with learning docs

package/lib/learn-mcp/README.md

@@ -0,0 +1,169 @@
+# coding-friend-learn-mcp
+
+MCP (Model Context Protocol) server that exposes your `/cf-learn` docs as tools for Claude — letting Claude read, search, write, and improve your learning notes directly.
+
+## Usage (via CLI)
+
+```bash
+cf mcp                     # setup MCP for docs/learn/
+cf mcp ./my-docs           # setup MCP for a custom directory
+```
+
+The CLI builds the server and prints the config to add to Claude Desktop / Claude Code.
+
+## Local Development
+
+Run the server directly without the CLI — useful when working on tools or docs logic.
+
+### 1. Install dependencies
+
+```bash
+cd cli/lib/learn-mcp
+npm install
+```
+
+### 2. Run with tsx (no build needed)
+
+The server accepts the docs directory as the first CLI argument, or via `LEARN_DOCS_DIR` env var.
+
+```bash
+# Using argument
+npx tsx src/index.ts /path/to/your/docs/learn
+
+# Using env var
+LEARN_DOCS_DIR=/path/to/your/docs/learn npx tsx src/index.ts
+
+# Point to this repo's own learn docs
+npx tsx src/index.ts ../../../docs/learn
+```
+
+The server communicates over stdio (MCP protocol), so you won't see output when running manually — it's meant to be connected to Claude.
+
+### 3. Connect to Claude Code (dev mode)
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "coding-friend-learn": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "tsx",
+        "/path/to/coding-friend/cli/lib/learn-mcp/src/index.ts",
+        "/path/to/your/docs/learn"
+      ]
+    }
+  }
+}
+```
+
+Or for Claude Desktop, add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "coding-friend-learn": {
+      "command": "npx",
+      "args": [
+        "tsx",
+        "/path/to/coding-friend/cli/lib/learn-mcp/src/index.ts",
+        "/path/to/your/docs/learn"
+      ]
+    }
+  }
+}
+```
+
+### 4. Watch mode (auto-rebuild)
+
+Keep a terminal running to auto-rebuild on every file change:
+
+```bash
+npm run dev:watch
+```
+
+Then restart the MCP server in Claude Code (`/mcp` → restart) to pick up the latest changes.
+
+### 5. Build and run compiled
+
+```bash
+npm run build
+node dist/index.js /path/to/docs/learn
+```
+
+## Docs Directory Structure
+
+```
+docs/
+└── learn/
+    ├── category-one/
+    │   ├── my-doc.md
+    │   └── another-doc.md
+    └── category-two/
+        └── some-doc.md
+```
+
+Each `.md` file needs frontmatter:
+
+```md
+---
+title: My Doc Title
+category: category-one
+tags: [typescript, patterns]
+created: 2025-01-01
+updated: 2025-01-15
+---
+
+Content here...
+```
+
+## Available Tools
+
+| Tool              | Type  | Description                                      |
+| ----------------- | ----- | ------------------------------------------------ |
+| `list-categories` | Read  | List all doc categories                          |
+| `list-docs`       | Read  | List docs (optionally filter by category or tag) |
+| `read-doc`        | Read  | Read a specific doc by category + slug           |
+| `search-docs`     | Read  | Full-text search across all docs                 |
+| `get-review-list` | Read  | Get docs needing review                          |
+| `create-doc`      | Write | Create a new doc with frontmatter                |
+| `update-doc`      | Write | Append content or update tags on an existing doc |
+| `improve-doc`     | Write | Replace doc content while preserving frontmatter |
+| `track-knowledge` | Write | Mark a doc as remembered / needs-review / new    |
+
+## Structure
+
+```
+src/
+├── index.ts          # Entry: parses docs dir, starts MCP server
+├── server.ts         # Registers all tools
+├── bin/
+│   └── learn-mcp.ts  # CLI binary entry
+├── tools/            # One file per MCP tool
+│   ├── list-categories.ts
+│   ├── list-docs.ts
+│   ├── read-doc.ts
+│   ├── search-docs.ts
+│   ├── create-doc.ts
+│   ├── update-doc.ts
+│   ├── improve-doc.ts
+│   ├── track-knowledge.ts
+│   └── get-review-list.ts
+└── lib/
+    ├── docs.ts       # Shared doc utilities (read, write, search)
+    ├── types.ts      # TypeScript interfaces
+    └── knowledge.ts  # Knowledge tracking state
+```
+
+## How It Fits Together
+
+```
+cf mcp [path]
+  └─ resolves docs dir
+  └─ npm install + build (one-time)
+  └─ prints MCP config to add to Claude
+```
+
+Once configured, Claude can call these tools directly to read and write your learning notes without leaving the conversation.

package/lib/learn-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-friend-learn-mcp",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "private": true,
   "type": "module",
   "bin": {
@@ -9,6 +9,7 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsx src/index.ts",
+    "dev:watch": "tsc --watch --preserveWatchOutput",
     "start": "node dist/index.js"
   },
   "dependencies": {

package/lib/learn-mcp/src/index.ts

@@ -8,7 +8,7 @@ const docsDir = path.resolve(rawDir);
 
 const server = new McpServer({
   name: "coding-friend-learn",
-  version: "1.0.0",
+  version: "0.0.1",
 });
 
 registerAllTools(server, docsDir);

package/lib/learn-mcp/src/lib/docs.ts

@@ -181,9 +181,7 @@ export function updateDoc(
   const today = new Date().toISOString().split("T")[0];
 
   if (updates.tags) {
-    raw.data.tags = [
-      ...new Set([...(raw.data.tags || []), ...updates.tags]),
-    ];
+    raw.data.tags = [...new Set([...(raw.data.tags || []), ...updates.tags])];
   }
   if (updates.title) {
     raw.data.title = updates.title;

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

@@ -71,7 +71,8 @@ export function getReviewList(
       lastReviewed: null,
       reviewCount: 0,
       notes: "",
-      firstSeen: doc.frontmatter.created || new Date().toISOString().split("T")[0]!,
+      firstSeen:
+        doc.frontmatter.created || new Date().toISOString().split("T")[0]!,
     };
 
     if (statusFilter && entry.status !== statusFilter) continue;

package/lib/learn-mcp/src/tools/get-review-list.ts

@@ -14,10 +14,7 @@ export function registerGetReviewList(
         .enum(["needs-review", "new"])
         .optional()
         .describe("Filter by specific status"),
-      limit: z
-        .number()
-        .optional()
-        .describe("Max number of results to return"),
+      limit: z.number().optional().describe("Max number of results to return"),
     },
     async ({ status, limit }) => {
       const results = getReviewList(docsDir, status, limit);

package/lib/learn-mcp/src/tools/search-docs.ts

@@ -8,10 +8,7 @@ export function registerSearchDocs(server: McpServer, docsDir: string): void {
     "Full-text search across all learning docs. Searches titles, tags, and content. Optionally filter by category.",
     {
       query: z.string().describe("Search query text"),
-      category: z
-        .string()
-        .optional()
-        .describe("Limit search to this category"),
+      category: z.string().optional().describe("Limit search to this category"),
     },
     async ({ query, category }) => {
       const results = searchDocs(docsDir, query, category);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-friend-cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "CLI for coding-friend — host learning docs, setup MCP server, initialize projects",
   "type": "module",
   "bin": {
@@ -9,7 +9,7 @@
   "scripts": {
     "build": "tsup src/index.ts src/postinstall.ts --format esm --dts --clean",
     "postinstall": "test -f dist/postinstall.js && node dist/postinstall.js || true",
-    "prepublishOnly": "npm run build && node scripts/bundle-libs.js",
+    "prepublishOnly": "npm run build",
     "dev": "tsx src/index.ts",
     "watch": "tsup src/index.ts src/postinstall.ts --format esm --dts --watch",
     "test": "vitest run",

package/lib/learn-host/public/_pagefind/pagefind-entry.json

@@ -1 +0,0 @@
-{"version":"1.4.0","languages":{"en":{"hash":"en_46bfc9f7e1","wasm":"en","page_count":14}},"include_characters":["_","‿","⁀","⁔","︳","︴","﹍","﹎","﹏","＿"]}