coding-friend-cli 1.1.1 → 1.2.1

package/dist/{init-E6CL3UZQ.js → init-CTCDQKIQ.js}

@@ -4,7 +4,7 @@ import {
 import {
   ensureShellCompletion,
   hasShellCompletion
-} from "./chunk-VHZQ6KEU.js";
+} from "./chunk-CSF4FAHL.js";
 import {
   run
 } from "./chunk-UFGNO6CW.js";
@@ -13,7 +13,7 @@ import {
   globalConfigPath,
   localConfigPath,
   resolvePath
-} from "./chunk-AQXTNLQD.js";
+} from "./chunk-6OI37OZX.js";
 import {
   log
 } from "./chunk-6DUFTBTO.js";
@@ -183,7 +183,9 @@ async function setupLearnConfig(gitAvailable = true) {
   });
   let categories = DEFAULT_CONFIG.learn.categories;
   if (catChoice === "custom") {
-    console.log('Enter categories (format: "name: description"). Empty line to finish.');
+    console.log(
+      'Enter categories (format: "name: description"). Empty line to finish.'
+    );
     const customCats = [];
     let keepGoing = true;
     while (keepGoing) {
@@ -265,7 +267,11 @@ async function setupClaudePermissions(outputDir, autoCommit) {
   }
   permissions.allow = [...existing, ...missing];
   settings.permissions = permissions;
-  const { readJson: _r, writeJson: _w, ...restImports } = await import("./json-2XS56OJY.js");
+  const {
+    readJson: _r,
+    writeJson: _w,
+    ...restImports
+  } = await import("./json-2XS56OJY.js");
   _w(settingsPath, settings);
   log.success(`Added ${missing.length} permission rules.`);
 }
@@ -287,9 +293,7 @@ function isDefaultConfig(config) {
 }
 async function saveConfig(config) {
   if (isDefaultConfig(config)) {
-    log.dim(
-      "All settings match defaults \u2014 no config file needed."
-    );
+    log.dim("All settings match defaults \u2014 no config file needed.");
     return;
   }
   const target = await select({
@@ -321,10 +325,20 @@ async function initCommand() {
   const hasExternalDir = checkLearnConfig() && isExternalOutputDir(resolvedOutputDir);
   const steps = [
     { name: "docs", label: "Create docs folders", done: checkDocsFolders() },
-    ...gitAvailable ? [{ name: "gitignore", label: "Configure .gitignore", done: checkGitignore() }] : [],
+    ...gitAvailable ? [
+      {
+        name: "gitignore",
+        label: "Configure .gitignore",
+        done: checkGitignore()
+      }
+    ] : [],
     { name: "language", label: "Set docs language", done: checkLanguage() },
     { name: "learn", label: "Configure /cf-learn", done: checkLearnConfig() },
-    { name: "completion", label: "Setup shell tab completion", done: hasShellCompletion() }
+    {
+      name: "completion",
+      label: "Setup shell tab completion",
+      done: hasShellCompletion()
+    }
   ];
   if (hasExternalDir && resolvedOutputDir) {
     steps.push({
@@ -405,10 +419,7 @@ async function initCommand() {
         break;
       case "permissions":
         if (resolvedOutputDir) {
-          await setupClaudePermissions(
-            resolvedOutputDir,
-            learnAutoCommit
-          );
+          await setupClaudePermissions(resolvedOutputDir, learnAutoCommit);
         }
         break;
     }

package/dist/{mcp-MWESK6UX.js → mcp-43HCE2KD.js}

@@ -1,12 +1,12 @@
 import {
   getLibPath,
   resolveDocsDir
-} from "./chunk-KZT4AFDW.js";
+} from "./chunk-Q4DKU5IG.js";
 import "./chunk-HRVSKMNA.js";
 import {
   run
 } from "./chunk-UFGNO6CW.js";
-import "./chunk-AQXTNLQD.js";
+import "./chunk-6OI37OZX.js";
 import {
   log
 } from "./chunk-6DUFTBTO.js";

package/dist/postinstall.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ensureShellCompletion
-} from "./chunk-VHZQ6KEU.js";
+} from "./chunk-CSF4FAHL.js";
 import "./chunk-6DUFTBTO.js";
 
 // src/postinstall.ts

package/dist/{statusline-7D6YU5YM.js → statusline-ARI7I5YM.js}

@@ -1,7 +1,7 @@
 import {
   claudeSettingsPath,
   pluginCachePath
-} from "./chunk-AQXTNLQD.js";
+} from "./chunk-6OI37OZX.js";
 import {
   log
 } from "./chunk-6DUFTBTO.js";

package/dist/{update-IH3G4SN5.js → update-GGCBM7U4.js}

@@ -1,6 +1,6 @@
 import {
   ensureShellCompletion
-} from "./chunk-VHZQ6KEU.js";
+} from "./chunk-CSF4FAHL.js";
 import {
   commandExists,
   run,
@@ -10,7 +10,7 @@ import {
   claudeSettingsPath,
   installedPluginsPath,
   pluginCachePath
-} from "./chunk-AQXTNLQD.js";
+} from "./chunk-6OI37OZX.js";
 import {
   log
 } from "./chunk-6DUFTBTO.js";
@@ -24,6 +24,15 @@ import { existsSync, readFileSync, readdirSync } from "fs";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 import chalk from "chalk";
+function semverCompare(a, b) {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+    if (diff !== 0) return diff > 0 ? 1 : -1;
+  }
+  return 0;
+}
 var __dirname = dirname(fileURLToPath(import.meta.url));
 function getCliVersion() {
   const pkg = JSON.parse(
@@ -117,10 +126,16 @@ async function updateCommand(opts) {
   const statuslineVersion = getStatuslineVersion();
   const cliVersion = getCliVersion();
   const latestCliVersion = getLatestCliVersion();
-  log.info(`Plugin version: ${currentVersion ? `v${currentVersion}` : chalk.yellow("not found")}`);
-  log.info(`Latest plugin version: ${latestVersion ? chalk.green(`v${latestVersion}`) : chalk.yellow("unknown (cannot reach GitHub)")}`);
+  log.info(
+    `Plugin version: ${currentVersion ? `v${currentVersion}` : chalk.yellow("not found")}`
+  );
+  log.info(
+    `Latest plugin version: ${latestVersion ? chalk.green(`v${latestVersion}`) : chalk.yellow("unknown (cannot reach GitHub)")}`
+  );
   log.info(`CLI version: v${cliVersion}`);
-  log.info(`Latest CLI version: ${latestCliVersion ? chalk.green(`v${latestCliVersion}`) : chalk.yellow("unknown (cannot reach npm)")}`);
+  log.info(
+    `Latest CLI version: ${latestCliVersion ? chalk.green(`v${latestCliVersion}`) : chalk.yellow("unknown (cannot reach npm)")}`
+  );
   log.info(
     `Statusline version: ${statuslineVersion ? chalk.green(`v${statuslineVersion}`) : chalk.yellow("not configured")}`
   );
@@ -130,37 +145,54 @@ async function updateCommand(opts) {
       log.warn(
         "Cannot check latest plugin version. Verify manually at https://github.com/dinhanhthi/coding-friend/releases"
       );
-    } else if (currentVersion === latestVersion) {
-      log.success(`Plugin already on the latest version (${chalk.green(`v${latestVersion}`)}).`);
+    } else if (!currentVersion) {
+      log.warn(
+        "Plugin not installed. Run: claude plugin install coding-friend@coding-friend-marketplace"
+      );
     } else {
-      log.step(`Plugin update available: ${chalk.yellow(`v${currentVersion}`)} \u2192 ${chalk.green(`v${latestVersion}`)}`);
-      if (!commandExists("claude")) {
-        log.error(
-          "Claude CLI not found. Install it first, or run: claude plugin update coding-friend@coding-friend-marketplace"
+      const cmp = semverCompare(currentVersion, latestVersion);
+      if (cmp === 0) {
+        log.success(
+          `Plugin already on the latest version (${chalk.green(`v${latestVersion}`)}).`
+        );
+      } else if (cmp > 0) {
+        log.info(
+          `Plugin is ahead of latest release (local: ${chalk.cyan(`v${currentVersion}`)}, latest: v${latestVersion}). Skipping.`
         );
       } else {
-        log.step("Updating plugin...");
-        const result = run("claude", [
-          "plugin",
-          "update",
-          "coding-friend@coding-friend-marketplace"
-        ]);
-        if (result === null) {
-          log.error("Plugin update failed. Try manually: claude plugin update coding-friend@coding-friend-marketplace");
+        log.step(
+          `Plugin update available: ${chalk.yellow(`v${currentVersion}`)} \u2192 ${chalk.green(`v${latestVersion}`)}`
+        );
+        if (!commandExists("claude")) {
+          log.error(
+            "Claude CLI not found. Install it first, or run: claude plugin update coding-friend@coding-friend-marketplace"
+          );
         } else {
-          log.success("Plugin updated!");
-          let newVersion = currentVersion;
-          for (let i = 0; i < 5; i++) {
-            newVersion = getInstalledVersion();
-            if (newVersion !== currentVersion) break;
-            if (i < 4) sleepSync(1e3);
-          }
-          if (newVersion !== currentVersion) {
-            log.success(`Plugin updated to ${chalk.green(`v${newVersion}`)}`);
-          } else {
-            log.warn(
-              "Version in installed_plugins.json unchanged. Cache may still have been updated."
+          log.step("Updating plugin...");
+          const result = run("claude", [
+            "plugin",
+            "update",
+            "coding-friend@coding-friend-marketplace"
+          ]);
+          if (result === null) {
+            log.error(
+              "Plugin update failed. Try manually: claude plugin update coding-friend@coding-friend-marketplace"
             );
+          } else {
+            log.success("Plugin updated!");
+            let newVersion = currentVersion;
+            for (let i = 0; i < 5; i++) {
+              newVersion = getInstalledVersion();
+              if (newVersion !== currentVersion) break;
+              if (i < 4) sleepSync(1e3);
+            }
+            if (newVersion !== currentVersion) {
+              log.success(`Plugin updated to ${chalk.green(`v${newVersion}`)}`);
+            } else {
+              log.warn(
+                "Version in installed_plugins.json unchanged. Cache may still have been updated."
+              );
+            }
           }
         }
       }
@@ -169,16 +201,33 @@ async function updateCommand(opts) {
   if (doCli) {
     if (!latestCliVersion) {
       log.warn("Cannot check latest CLI version from npm.");
-    } else if (cliVersion === latestCliVersion) {
-      log.success(`CLI already on the latest version (${chalk.green(`v${latestCliVersion}`)}).`);
     } else {
-      log.step(`CLI update available: ${chalk.yellow(`v${cliVersion}`)} \u2192 ${chalk.green(`v${latestCliVersion}`)}`);
-      log.step("Updating CLI...");
-      const result = run("npm", ["install", "-g", "coding-friend-cli@latest"]);
-      if (result === null) {
-        log.error("CLI update failed. Try manually: npm install -g coding-friend-cli@latest");
+      const cmp = semverCompare(cliVersion, latestCliVersion);
+      if (cmp === 0) {
+        log.success(
+          `CLI already on the latest version (${chalk.green(`v${latestCliVersion}`)}).`
+        );
+      } else if (cmp > 0) {
+        log.info(
+          `CLI is ahead of latest release (local: ${chalk.cyan(`v${cliVersion}`)}, latest: v${latestCliVersion}). Skipping.`
+        );
       } else {
-        log.success(`CLI updated to ${chalk.green(`v${latestCliVersion}`)}`);
+        log.step(
+          `CLI update available: ${chalk.yellow(`v${cliVersion}`)} \u2192 ${chalk.green(`v${latestCliVersion}`)}`
+        );
+        log.step("Updating CLI...");
+        const result = run("npm", [
+          "install",
+          "-g",
+          "coding-friend-cli@latest"
+        ]);
+        if (result === null) {
+          log.error(
+            "CLI update failed. Try manually: npm install -g coding-friend-cli@latest"
+          );
+        } else {
+          log.success(`CLI updated to ${chalk.green(`v${latestCliVersion}`)}`);
+        }
       }
     }
   }
@@ -187,7 +236,9 @@ async function updateCommand(opts) {
     if (targetVersion) {
       log.step("Updating statusline...");
       if (updateStatusline(targetVersion)) {
-        log.success(`Statusline updated to ${chalk.green(`v${targetVersion}`)}`);
+        log.success(
+          `Statusline updated to ${chalk.green(`v${targetVersion}`)}`
+        );
       }
     } else {
       log.warn("No cached plugin version found for statusline update.");

package/lib/learn-host/.prettierignore

@@ -0,0 +1,4 @@
+node_modules
+.next
+out
+public/_pagefind

package/lib/learn-host/.prettierrc

@@ -0,0 +1,8 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "trailingComma": "all",
+  "printWidth": 80,
+  "plugins": ["prettier-plugin-tailwindcss"]
+}

package/lib/learn-host/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog (Learn Host)
+
+## v0.0.2 (2026-03-01)
+
+- Update header styling for consistency with ecosystem redesign
+- Code formatting and style improvements
+
+## v0.0.1
+
+- Next.js app for hosting learning docs at `localhost:3333`
+- ISR (Incremental Static Regeneration) for auto-updating docs without rebuild
+- Full-text search via Pagefind
+- Modern UI with command palette, dark theme, and responsive layout
+- Markdown rendering with syntax highlighting and GFM support

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/eslint.config.mjs

@@ -0,0 +1,6 @@
+import nextConfig from "eslint-config-next";
+import eslintConfigPrettier from "eslint-config-prettier";
+
+const eslintConfig = [...nextConfig, eslintConfigPrettier];
+
+export default eslintConfig;

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

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-/// <reference path="./.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

@@ -3,6 +3,10 @@ import type { NextConfig } from "next";
 const nextConfig: NextConfig = {
   trailingSlash: true,
   images: { unoptimized: true },
+  reactCompiler: true,
+  turbopack: {
+    root: __dirname,
+  },
 };
 
 export default nextConfig;