coding-friend-cli 1.32.1 → 1.33.0

package/dist/{chunk-355AR2X5.js → chunk-G2P43ZK2.js}

@@ -6,25 +6,25 @@ import {
   getMemoryMcpStatus,
   memoryConfigMenu,
   writeMemoryMcpEntry
-} from "./chunk-5W7ZOVDU.js";
+} from "./chunk-NZKIYVIK.js";
 import {
   loadConfig,
   resolveMemoryDir
-} from "./chunk-GTX6I57V.js";
+} from "./chunk-LK6HFD35.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
 import {
   showConfigHint
-} from "./chunk-HPNRQYLM.js";
-import {
-  run,
-  runWithStderr
-} from "./chunk-EVGXUDX4.js";
+} from "./chunk-Z5Q533UG.js";
 import {
   globalConfigPath,
   localConfigPath
 } from "./chunk-TWKNGPBO.js";
+import {
+  run,
+  runWithStderr
+} from "./chunk-EVGXUDX4.js";
 import {
   log,
   printBanner
@@ -48,7 +48,9 @@ function warnStaleMcpJson(memoryDir) {
   if (!existsSync(localMcpPath)) return;
   const mcpJson = readJson(localMcpPath);
   if (mcpJson === null) {
-    log.warn(".mcp.json exists but could not be parsed \u2014 check for syntax errors.");
+    log.warn(
+      ".mcp.json exists but could not be parsed \u2014 check for syntax errors."
+    );
     return;
   }
   const state = detectMemoryMcpState(mcpJson, existsSync);
@@ -56,19 +58,33 @@ function warnStaleMcpJson(memoryDir) {
     if (memoryDir) {
       writeMemoryMcpEntry(memoryDir);
       if (state.kind === "stale") {
-        log.success("Auto-updated stale .mcp.json to version-stable npx format.");
+        log.success(
+          "Auto-updated stale .mcp.json to version-stable npx format."
+        );
       } else {
         log.success("Updated .mcp.json to version-stable npx format.");
       }
       console.log();
     } else if (state.kind === "stale") {
-      console.log(chalk.yellow(`\u26A0 Stale MCP config detected in .mcp.json`));
+      console.log(
+        chalk.yellow(`\u26A0 Stale MCP config detected in .mcp.json`)
+      );
       console.log(chalk.dim(`  Path no longer exists: ${state.path}`));
-      console.log(chalk.dim(`  Run "cf memory mcp" to update to the new format.`));
+      console.log(
+        chalk.dim(`  Run "cf memory mcp" to update to the new format.`)
+      );
       console.log();
     } else {
-      console.log(chalk.cyan(`\u2139 .mcp.json uses an absolute path for coding-friend-memory.`));
-      console.log(chalk.dim(`  Consider running "cf memory mcp" to switch to the version-stable format.`));
+      console.log(
+        chalk.cyan(
+          `\u2139 .mcp.json uses an absolute path for coding-friend-memory.`
+        )
+      );
+      console.log(
+        chalk.dim(
+          `  Consider running "cf memory mcp" to switch to the version-stable format.`
+        )
+      );
       console.log();
     }
   }
@@ -142,70 +158,25 @@ function ensureMemoryBuilt(mcpDir) {
     log.success("Done.");
   }
 }
-function printMemoryMcpConfig(serverPath, memoryDir) {
+function printMemoryMcpConfig(memoryDir) {
   console.log(chalk2.dim("Add this to your MCP client config:"));
   console.log();
-  console.log(
-    chalk2.yellow.bold("--- Claude Code (.mcp.json in project root) ---")
-  );
-  console.log(`
-{
+  console.log(`{
   "mcpServers": {
     "coding-friend-memory": {
       "command": "npx",
-      "args": ["-y", "coding-friend-cli", "mcp-serve", "${memoryDir}"]
-    }
-  }
-}`);
-  console.log();
-  console.log(
-    chalk2.yellow.bold(
-      "--- Claude Desktop / Claude Chat (claude_desktop_config.json) ---"
-    )
-  );
-  console.log(`
-{
-  "mcpServers": {
-    "coding-friend-memory": {
-      "command": "node",
-      "args": ["${serverPath}", "${memoryDir}"]
+      "args": [
+        "-y",
+        "coding-friend-cli",
+        "mcp-serve",
+        "${memoryDir}"
+      ]
     }
   }
 }`);
   console.log();
-  console.log(chalk2.yellow.bold("--- Generic MCP client ---"));
-  console.log(`
-Server command: node ${serverPath} ${memoryDir}
-Transport: stdio`);
-  console.log();
-  console.log(chalk2.yellow.bold("--- Available tools ---"));
-  console.log();
-  console.log(
-    `  ${chalk2.white("memory_store")}       ${chalk2.dim("Store a new memory")}`
-  );
-  console.log(
-    `  ${chalk2.white("memory_search")}      ${chalk2.dim("Search memories (keyword match)")}`
-  );
-  console.log(
-    `  ${chalk2.white("memory_retrieve")}    ${chalk2.dim("Get a specific memory by ID")}`
-  );
-  console.log(
-    `  ${chalk2.white("memory_list")}        ${chalk2.dim("List memories with filtering")}`
-  );
-  console.log(
-    `  ${chalk2.white("memory_update")}      ${chalk2.dim("Update existing memory")}`
-  );
-  console.log(
-    `  ${chalk2.white("memory_delete")}      ${chalk2.dim("Delete a memory")}`
-  );
-  console.log();
-  console.log(chalk2.yellow.bold("--- Resources ---"));
-  console.log();
-  console.log(
-    `  ${chalk2.white("memory://index")}     ${chalk2.dim("Browse all memories")}`
-  );
-  console.log(
-    `  ${chalk2.white("memory://stats")}     ${chalk2.dim("Storage statistics")}`
+  log.dim(
+    "Available tools & resources: https://cf.dinhanhthi.com/docs/cli/cf-mcp/"
   );
   console.log();
   log.warn(
@@ -906,8 +877,7 @@ async function memoryMcpCommand() {
   const mcpDir = getLibPath("cf-memory");
   ensureMemoryBuilt(mcpDir);
   warnStaleMcpJson(memoryDir);
-  const serverPath = join2(mcpDir, "dist", "index.js");
-  printMemoryMcpConfig(serverPath, memoryDir);
+  printMemoryMcpConfig(memoryDir);
 }
 
 export {

package/dist/{chunk-GTX6I57V.js → chunk-LK6HFD35.js}

@@ -1,6 +1,6 @@
 import {
   DEFAULT_CONFIG
-} from "./chunk-DHH6SRXV.js";
+} from "./chunk-OYPOADCX.js";
 import {
   globalConfigPath,
   localConfigPath,
@@ -66,6 +66,11 @@ var MemoryConfigSchema = z.object({
   autoCapture: z.boolean().optional(),
   autoStart: z.boolean().optional()
 });
+var CodexConfigSchema = z.strictObject({
+  enabled: z.boolean().optional(),
+  modes: z.array(z.enum(["QUICK", "STANDARD", "DEEP"])).optional(),
+  effort: z.enum(["minimal", "low", "medium", "high", "xhigh"]).optional()
+});
 var ConfigSchema = z.strictObject({
   language: z.string().optional(),
   docsDir: z.string().optional(),
@@ -74,7 +79,8 @@ var ConfigSchema = z.strictObject({
   memory: MemoryConfigSchema.optional(),
   autoApprove: z.boolean().optional(),
   autoApproveIgnore: z.array(z.string()).optional(),
-  autoApproveAllowExtra: z.array(z.string()).optional()
+  autoApproveAllowExtra: z.array(z.string()).optional(),
+  codex: CodexConfigSchema.optional()
 });
 var KNOWN_KEYS = [
   "language",
@@ -84,7 +90,8 @@ var KNOWN_KEYS = [
   "memory",
   "autoApprove",
   "autoApproveIgnore",
-  "autoApproveAllowExtra"
+  "autoApproveAllowExtra",
+  "codex"
 ];
 function suggestKey(unknown) {
   let best = null;
@@ -123,10 +130,12 @@ function validateConfig(merged) {
     if (issue.code === "unrecognized_keys") {
       const keys = issue.keys ?? [];
       for (const key of keys) {
-        const suggestion = suggestKey(key);
+        const isNested = issue.path.length > 0;
+        const fullKey = isNested ? `${issue.path.join(".")}.${key}` : key;
+        const suggestion = isNested ? null : suggestKey(key);
         const hint = suggestion ? ` Did you mean '${suggestion}'?` : "";
-        log.warn(`Unknown config key '${key}'.${hint}`);
-        delete sanitized[key];
+        log.warn(`Unknown config key '${fullKey}'.${hint}`);
+        stripPath(sanitized, [...issue.path, key]);
       }
     } else {
       log.warn(`Config: ${pathStr} \u2014 ${issue.message}. Using default.`);

package/dist/{chunk-5W7ZOVDU.js → chunk-NZKIYVIK.js}

@@ -1,6 +1,6 @@
 import {
   resolveMemoryDir
-} from "./chunk-GTX6I57V.js";
+} from "./chunk-LK6HFD35.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
@@ -9,7 +9,7 @@ import {
   askScope,
   formatScopeLabel,
   injectBackChoice
-} from "./chunk-HPNRQYLM.js";
+} from "./chunk-Z5Q533UG.js";
 import {
   globalConfigPath,
   localConfigPath

package/dist/{chunk-DHH6SRXV.js → chunk-OYPOADCX.js}

@@ -22,6 +22,7 @@ var ALL_COMPONENT_IDS = STATUSLINE_COMPONENTS.map((c) => c.id);
 var DEFAULT_CONFIG = {
   language: "en",
   docsDir: "docs",
+  codex: { enabled: false, modes: ["STANDARD", "DEEP"], effort: "medium" },
   learn: {
     language: "en",
     outputDir: "docs/learn",

package/dist/{chunk-4IUUWBZG.js → chunk-UGTNIFBH.js}

@@ -1,22 +1,22 @@
 import {
   ensureStatusline,
   getInstalledVersion
-} from "./chunk-LXZ47XCD.js";
+} from "./chunk-XOHLBLN2.js";
 import {
   ensureShellCompletion
 } from "./chunk-DMJCO6LJ.js";
 import {
   resolveScope
-} from "./chunk-HPNRQYLM.js";
+} from "./chunk-Z5Q533UG.js";
+import {
+  claudeSettingsPath
+} from "./chunk-TWKNGPBO.js";
 import {
   commandExists,
   run,
   runWithStderr,
   sleepSync
 } from "./chunk-EVGXUDX4.js";
-import {
-  claudeSettingsPath
-} from "./chunk-TWKNGPBO.js";
 import {
   log,
   printBanner

package/dist/{chunk-LXZ47XCD.js → chunk-XOHLBLN2.js}

@@ -1,7 +1,7 @@
 import {
   ALL_COMPONENT_IDS,
   STATUSLINE_COMPONENTS
-} from "./chunk-DHH6SRXV.js";
+} from "./chunk-OYPOADCX.js";
 import {
   claudeSettingsPath,
   globalConfigPath,

package/dist/{config-FUEEFM5N.js → config-TAYQIBPL.js}

@@ -1,7 +1,7 @@
 import {
   memoryConfigMenu
-} from "./chunk-5W7ZOVDU.js";
-import "./chunk-GTX6I57V.js";
+} from "./chunk-NZKIYVIK.js";
+import "./chunk-LK6HFD35.js";
 import "./chunk-RZRT7NGT.js";
 import {
   findStatuslineHookPath,
@@ -13,11 +13,11 @@ import {
   saveStatuslineConfig,
   selectStatuslineComponents,
   writeStatuslineSettings
-} from "./chunk-LXZ47XCD.js";
+} from "./chunk-XOHLBLN2.js";
 import {
   ALL_COMPONENT_IDS,
   DEFAULT_CONFIG
-} from "./chunk-DHH6SRXV.js";
+} from "./chunk-OYPOADCX.js";
 import {
   ensureShellCompletion,
   hasShellCompletion,
@@ -32,10 +32,7 @@ import {
   getScopeLabel,
   injectBackChoice,
   showConfigHint
-} from "./chunk-HPNRQYLM.js";
-import {
-  run
-} from "./chunk-EVGXUDX4.js";
+} from "./chunk-Z5Q533UG.js";
 import {
   claudeLocalSettingsPath,
   claudeProjectSettingsPath,
@@ -44,6 +41,9 @@ import {
   localConfigPath,
   resolvePath
 } from "./chunk-TWKNGPBO.js";
+import {
+  run
+} from "./chunk-EVGXUDX4.js";
 import {
   log,
   printBanner
@@ -593,7 +593,7 @@ async function editPermissions() {
     )
   });
   if (choice === BACK) return;
-  const { permissionCommand } = await import("./permission-C5R3LMZQ.js");
+  const { permissionCommand } = await import("./permission-DNW7DE24.js");
   switch (choice) {
     case "interactive":
       await permissionCommand({});

package/dist/{dev-VNDV6R24.js → dev-S6VZUD33.js}

@@ -1,7 +1,7 @@
 import {
   ensureStatusline
-} from "./chunk-LXZ47XCD.js";
-import "./chunk-DHH6SRXV.js";
+} from "./chunk-XOHLBLN2.js";
+import "./chunk-OYPOADCX.js";
 import {
   ensureShellCompletion
 } from "./chunk-DMJCO6LJ.js";
@@ -9,15 +9,15 @@ import {
   isMarketplaceRegistered,
   isPluginInstalled
 } from "./chunk-R6HDMRYL.js";
-import {
-  commandExists,
-  run
-} from "./chunk-EVGXUDX4.js";
 import {
   devStatePath,
   knownMarketplacesPath,
   pluginCachePath
 } from "./chunk-TWKNGPBO.js";
+import {
+  commandExists,
+  run
+} from "./chunk-EVGXUDX4.js";
 import {
   log,
   printBanner

package/dist/{disable-CDOM7SSI.js → disable-ZWQVU3QZ.js}

@@ -4,9 +4,9 @@ import {
 } from "./chunk-R6HDMRYL.js";
 import {
   resolveScope
-} from "./chunk-HPNRQYLM.js";
-import "./chunk-EVGXUDX4.js";
+} from "./chunk-Z5Q533UG.js";
 import "./chunk-TWKNGPBO.js";
+import "./chunk-EVGXUDX4.js";
 import {
   log
 } from "./chunk-NREZK463.js";

package/dist/{enable-SF7742UR.js → enable-NXP6APNI.js}

@@ -4,9 +4,9 @@ import {
 } from "./chunk-R6HDMRYL.js";
 import {
   resolveScope
-} from "./chunk-HPNRQYLM.js";
-import "./chunk-EVGXUDX4.js";
+} from "./chunk-Z5Q533UG.js";
 import "./chunk-TWKNGPBO.js";
+import "./chunk-EVGXUDX4.js";
 import {
   log
 } from "./chunk-NREZK463.js";

package/dist/{host-RNYPAE4D.js → host-Y4N4PI4N.js}

@@ -1,15 +1,15 @@
 import {
   resolveDocsDir
-} from "./chunk-GTX6I57V.js";
+} from "./chunk-LK6HFD35.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
-import "./chunk-DHH6SRXV.js";
+import "./chunk-OYPOADCX.js";
+import "./chunk-TWKNGPBO.js";
 import {
   run,
   streamExec
 } from "./chunk-EVGXUDX4.js";
-import "./chunk-TWKNGPBO.js";
 import {
   log,
   printBanner

package/dist/index.js

@@ -14,58 +14,62 @@ program.name("cf").description(
   "coding-friend CLI \u2014 host learning docs, setup MCP, init projects"
 ).version(pkg.version, "-v, --version");
 program.command("install").description("Install the Coding Friend plugin into Claude Code").option("--user", "Install at user scope (all projects)").option("--global", "Install at user scope (all projects)").option("--project", "Install at project scope (shared via git)").option("--local", "Install at local scope (this machine only)").action(async (opts) => {
-  const { installCommand } = await import("./install-JR4ITJVU.js");
+  const { installCommand } = await import("./install-FKL6WLIG.js");
   await installCommand(opts);
 });
 program.command("uninstall").description("Uninstall the Coding Friend plugin from Claude Code").option("--user", "Uninstall from user scope (all projects)").option("--global", "Uninstall from user scope (all projects)").option("--project", "Uninstall from project scope").option("--local", "Uninstall from local scope").action(async (opts) => {
-  const { uninstallCommand } = await import("./uninstall-BOVKPNYN.js");
+  const { uninstallCommand } = await import("./uninstall-6ZJRS2H4.js");
   await uninstallCommand(opts);
 });
 program.command("disable").description("Disable the Coding Friend plugin without uninstalling").option("--user", "Disable at user scope (all projects)").option("--global", "Disable at user scope (all projects)").option("--project", "Disable at project scope").option("--local", "Disable at local scope").action(async (opts) => {
-  const { disableCommand } = await import("./disable-CDOM7SSI.js");
+  const { disableCommand } = await import("./disable-ZWQVU3QZ.js");
   await disableCommand(opts);
 });
 program.command("enable").description("Re-enable the Coding Friend plugin").option("--user", "Enable at user scope (all projects)").option("--global", "Enable at user scope (all projects)").option("--project", "Enable at project scope").option("--local", "Enable at local scope").action(async (opts) => {
-  const { enableCommand } = await import("./enable-SF7742UR.js");
+  const { enableCommand } = await import("./enable-NXP6APNI.js");
   await enableCommand(opts);
 });
 program.command("init").description("Initialize coding-friend in current project").action(async () => {
-  const { initCommand } = await import("./init-3UITY4LD.js");
+  const { initCommand } = await import("./init-QZG3RV5S.js");
   await initCommand();
 });
 program.command("config").description("Manage Coding Friend configuration").action(async () => {
-  const { configCommand } = await import("./config-FUEEFM5N.js");
+  const { configCommand } = await import("./config-TAYQIBPL.js");
   await configCommand();
 });
 program.command("host").description("Build and serve learning docs as a static website").argument("[path]", "path to docs folder").option("-p, --port <port>", "port number", "3333").action(async (path, opts) => {
-  const { hostCommand } = await import("./host-RNYPAE4D.js");
+  const { hostCommand } = await import("./host-Y4N4PI4N.js");
   await hostCommand(path, opts);
 });
 program.command("mcp").description("Setup MCP server for learning docs").argument("[path]", "path to docs folder").action(async (path) => {
-  const { mcpCommand } = await import("./mcp-LJ5NX6XE.js");
+  const { mcpCommand } = await import("./mcp-BD2K7OL6.js");
   await mcpCommand(path);
 });
 program.command("mcp-serve").description("Start the cf-memory MCP server (used internally by npx)").argument("<memoryDir>", "path to memory directory").action(async (memoryDir) => {
   const { mcpServeCommand } = await import("./mcp-serve-3FEPFVVQ.js");
   await mcpServeCommand(memoryDir);
 });
+program.command("mcp-serve-learn").description("Start the learn MCP server (used internally by npx)").argument("<docsDir>", "path to docs directory").action(async (docsDir) => {
+  const { mcpServeLearnCommand } = await import("./mcp-serve-learn-UNW6VH5M.js");
+  await mcpServeLearnCommand(docsDir);
+});
 program.command("permission").description("Manage Claude Code permission rules for Coding Friend").option("--all", "Apply all recommended permissions without prompts").option("--user", "Save to user-level settings (~/.claude/settings.json)").option(
   "--project",
   "Save to project-level settings (.claude/settings.local.json)"
 ).action(async (opts) => {
-  const { permissionCommand } = await import("./permission-C5R3LMZQ.js");
+  const { permissionCommand } = await import("./permission-DNW7DE24.js");
   await permissionCommand(opts);
 });
 program.command("statusline").description("Setup coding-friend statusline in Claude Code").action(async () => {
-  const { statuslineCommand } = await import("./statusline-5X7FZGRU.js");
+  const { statuslineCommand } = await import("./statusline-MLLKBHHR.js");
   await statuslineCommand();
 });
 program.command("update").description("Update coding-friend plugin, CLI, and statusline").option("--cli", "Update only the CLI (npm package)").option("--plugin", "Update only the Claude Code plugin").option("--statusline", "Update only the statusline").option("--user", "Update plugin at user scope (all projects)").option("--global", "Update plugin at user scope (all projects)").option("--project", "Update plugin at project scope").option("--local", "Update plugin at local scope").action(async (opts) => {
-  const { updateCommand } = await import("./update-JBCG4CY2.js");
+  const { updateCommand } = await import("./update-G5HZINBK.js");
   await updateCommand(opts);
 });
 program.command("status").description("Show comprehensive Coding Friend status").action(async () => {
-  const { statusCommand } = await import("./status-FU5GR3MP.js");
+  const { statusCommand } = await import("./status-V2A7RSSM.js");
   await statusCommand();
 });
 var session = program.command("session").description("Save and load Claude Code sessions across machines");
@@ -80,11 +84,11 @@ session.command("save").description("Save current Claude Code session to sync fo
   "-s, --session-id <id>",
   "session UUID to save (default: auto-detect newest)"
 ).option("-l, --label <label>", "label for this session").action(async (opts) => {
-  const { sessionSaveCommand } = await import("./session-FMC2MG6C.js");
+  const { sessionSaveCommand } = await import("./session-RHXTVNRU.js");
   await sessionSaveCommand(opts);
 });
 session.command("load").description("Load a saved session from sync folder").action(async () => {
-  const { sessionLoadCommand } = await import("./session-FMC2MG6C.js");
+  const { sessionLoadCommand } = await import("./session-RHXTVNRU.js");
   await sessionLoadCommand();
 });
 var memory = program.command("memory").description("AI memory system \u2014 store and search project knowledge");
@@ -104,43 +108,43 @@ Memory subcommands:
   memory mcp          Show MCP server setup instructions`
 );
 memory.command("status").description("Show memory system status").action(async () => {
-  const { memoryStatusCommand } = await import("./memory-2ZD4WU3S.js");
+  const { memoryStatusCommand } = await import("./memory-FZMACIGE.js");
   await memoryStatusCommand();
 });
 memory.command("search").description("Search memories by query").argument("<query>", "search query").action(async (query) => {
-  const { memorySearchCommand } = await import("./memory-2ZD4WU3S.js");
+  const { memorySearchCommand } = await import("./memory-FZMACIGE.js");
   await memorySearchCommand(query);
 });
 memory.command("list").description(
   "List memories in current project, or all projects with --projects"
 ).option("--projects", "List all project databases with size and metadata").action(async (opts) => {
-  const { memoryListCommand } = await import("./memory-2ZD4WU3S.js");
+  const { memoryListCommand } = await import("./memory-FZMACIGE.js");
   await memoryListCommand(opts);
 });
 memory.command("init").description(
   "Initialize memory system \u2014 interactive wizard (first time) or config menu"
 ).action(async () => {
-  const { memoryInitCommand } = await import("./memory-2ZD4WU3S.js");
+  const { memoryInitCommand } = await import("./memory-FZMACIGE.js");
   await memoryInitCommand();
 });
 memory.command("config").description("Configure memory system settings").action(async () => {
-  const { memoryConfigCommand } = await import("./memory-2ZD4WU3S.js");
+  const { memoryConfigCommand } = await import("./memory-FZMACIGE.js");
   await memoryConfigCommand();
 });
 memory.command("start-daemon").description("Start the memory daemon (Tier 2 \u2014 MiniSearch)").action(async () => {
-  const { memoryStartDaemonCommand } = await import("./memory-2ZD4WU3S.js");
+  const { memoryStartDaemonCommand } = await import("./memory-FZMACIGE.js");
   await memoryStartDaemonCommand();
 });
 memory.command("stop-daemon").description("Stop the memory daemon").action(async () => {
-  const { memoryStopDaemonCommand } = await import("./memory-2ZD4WU3S.js");
+  const { memoryStopDaemonCommand } = await import("./memory-FZMACIGE.js");
   await memoryStopDaemonCommand();
 });
 memory.command("rebuild").description("Rebuild the daemon search index").action(async () => {
-  const { memoryRebuildCommand } = await import("./memory-2ZD4WU3S.js");
+  const { memoryRebuildCommand } = await import("./memory-FZMACIGE.js");
   await memoryRebuildCommand();
 });
 memory.command("mcp").description("Show MCP server setup instructions").action(async () => {
-  const { memoryMcpCommand } = await import("./memory-2ZD4WU3S.js");
+  const { memoryMcpCommand } = await import("./memory-FZMACIGE.js");
   await memoryMcpCommand();
 });
 memory.command("rm").description("Remove a project database").option("--project-id <id>", "Project ID to remove").option("--all", "Remove all project databases").option(
@@ -148,7 +152,7 @@ memory.command("rm").description("Remove a project database").option("--project-
   "Remove orphaned projects (source dir missing or 0 memories)"
 ).action(
   async (opts) => {
-    const { memoryRmCommand } = await import("./memory-2ZD4WU3S.js");
+    const { memoryRmCommand } = await import("./memory-FZMACIGE.js");
     await memoryRmCommand(opts);
   }
 );
@@ -174,41 +178,41 @@ Dev subcommands:
   dev update [path]   Update local dev plugin to latest version`
 );
 dev.command("on").description("Switch to local plugin source").argument("[path]", "path to local coding-friend repo (default: cwd)").action(async (path) => {
-  const { devOnCommand } = await import("./dev-VNDV6R24.js");
+  const { devOnCommand } = await import("./dev-S6VZUD33.js");
   await devOnCommand(path);
 });
 dev.command("off").description("Switch back to remote marketplace").action(async () => {
-  const { devOffCommand } = await import("./dev-VNDV6R24.js");
+  const { devOffCommand } = await import("./dev-S6VZUD33.js");
   await devOffCommand();
 });
 dev.command("status").description("Show current dev mode").action(async () => {
-  const { devStatusCommand } = await import("./dev-VNDV6R24.js");
+  const { devStatusCommand } = await import("./dev-S6VZUD33.js");
   await devStatusCommand();
 });
 dev.command("sync").description(
   "Copy local source files to plugin cache (no version bump needed)"
 ).action(async () => {
-  const { devSyncCommand } = await import("./dev-VNDV6R24.js");
+  const { devSyncCommand } = await import("./dev-S6VZUD33.js");
   await devSyncCommand();
 });
 dev.command("restart").description("Reinstall local dev plugin (off + on)").argument(
   "[path]",
   "path to local coding-friend repo (default: saved path or cwd)"
 ).action(async (path) => {
-  const { devRestartCommand } = await import("./dev-VNDV6R24.js");
+  const { devRestartCommand } = await import("./dev-S6VZUD33.js");
   await devRestartCommand(path);
 });
 dev.command("update").description("Update local dev plugin to latest version (off + on)").argument(
   "[path]",
   "path to local coding-friend repo (default: saved path or cwd)"
 ).action(async (path) => {
-  const { devUpdateCommand } = await import("./dev-VNDV6R24.js");
+  const { devUpdateCommand } = await import("./dev-S6VZUD33.js");
   await devUpdateCommand(path);
 });
 program.hook("postAction", async () => {
   const topCmd = process.argv[2];
   if (topCmd === "update") return;
-  const { checkAndNotifyCliUpdate } = await import("./update-check-BPCQ25AR.js");
+  const { checkAndNotifyCliUpdate } = await import("./update-check-5SCD2JR2.js");
   checkAndNotifyCliUpdate(pkg.version);
 });
 await program.parseAsync();

package/dist/{init-3UITY4LD.js → init-QZG3RV5S.js}

@@ -2,11 +2,11 @@ import {
   ensureMemoryBuilt,
   isMemoryInitialized,
   memoryInitWizard
-} from "./chunk-355AR2X5.js";
+} from "./chunk-G2P43ZK2.js";
 import {
   memoryConfigMenu
-} from "./chunk-5W7ZOVDU.js";
-import "./chunk-GTX6I57V.js";
+} from "./chunk-NZKIYVIK.js";
+import "./chunk-LK6HFD35.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
@@ -20,10 +20,10 @@ import {
   saveStatuslineConfig,
   selectStatuslineComponents,
   writeStatuslineSettings
-} from "./chunk-LXZ47XCD.js";
+} from "./chunk-XOHLBLN2.js";
 import {
   DEFAULT_CONFIG
-} from "./chunk-DHH6SRXV.js";
+} from "./chunk-OYPOADCX.js";
 import {
   ensureShellCompletion,
   hasShellCompletion
@@ -38,11 +38,7 @@ import {
   getScopeLabel,
   injectBackChoice,
   showConfigHint
-} from "./chunk-HPNRQYLM.js";
-import {
-  commandExists,
-  run
-} from "./chunk-EVGXUDX4.js";
+} from "./chunk-Z5Q533UG.js";
 import {
   claudeLocalSettingsPath,
   claudeProjectSettingsPath,
@@ -51,6 +47,10 @@ import {
   localConfigPath,
   resolvePath
 } from "./chunk-TWKNGPBO.js";
+import {
+  commandExists,
+  run
+} from "./chunk-EVGXUDX4.js";
 import {
   log,
   printBanner

package/dist/{install-JR4ITJVU.js → install-FKL6WLIG.js}

@@ -1,11 +1,11 @@
 import {
   getLatestVersion,
   semverCompare
-} from "./chunk-4IUUWBZG.js";
+} from "./chunk-UGTNIFBH.js";
 import {
   getInstalledVersion
-} from "./chunk-LXZ47XCD.js";
-import "./chunk-DHH6SRXV.js";
+} from "./chunk-XOHLBLN2.js";
+import "./chunk-OYPOADCX.js";
 import {
   ensureShellCompletion
 } from "./chunk-DMJCO6LJ.js";
@@ -16,14 +16,14 @@ import {
 } from "./chunk-R6HDMRYL.js";
 import {
   resolveScope
-} from "./chunk-HPNRQYLM.js";
+} from "./chunk-Z5Q533UG.js";
+import {
+  devStatePath
+} from "./chunk-TWKNGPBO.js";
 import {
   commandExists,
   run
 } from "./chunk-EVGXUDX4.js";
-import {
-  devStatePath
-} from "./chunk-TWKNGPBO.js";
 import {
   log,
   printBanner

package/dist/{mcp-LJ5NX6XE.js → mcp-BD2K7OL6.js}

@@ -3,21 +3,21 @@ import {
   ensureMemoryBuilt,
   printMemoryMcpConfig,
   warnStaleMcpJson
-} from "./chunk-355AR2X5.js";
-import "./chunk-5W7ZOVDU.js";
+} from "./chunk-G2P43ZK2.js";
+import "./chunk-NZKIYVIK.js";
 import {
   resolveDocsDir,
   resolveMemoryDir
-} from "./chunk-GTX6I57V.js";
+} from "./chunk-LK6HFD35.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
-import "./chunk-DHH6SRXV.js";
-import "./chunk-HPNRQYLM.js";
+import "./chunk-OYPOADCX.js";
+import "./chunk-Z5Q533UG.js";
+import "./chunk-TWKNGPBO.js";
 import {
   run
 } from "./chunk-EVGXUDX4.js";
-import "./chunk-TWKNGPBO.js";
 import {
   log,
   printBanner
@@ -57,7 +57,6 @@ async function mcpCommand(path) {
   printBanner("\u{1F4DA} Learn MCP");
   log.info(`Docs folder: ${chalk.cyan(docsDir)}`);
   log.info(`Found: ${chalk.green(docCount)} docs`);
-  console.log();
   if (!existsSync(join(mcpDir, "node_modules"))) {
     log.step("Installing MCP server dependencies (one-time setup)...");
     const result = run("npm", ["install", "--silent"], { cwd: mcpDir });
@@ -77,60 +76,24 @@ async function mcpCommand(path) {
     log.success("Done.");
   }
   console.log();
-  const serverPath = join(mcpDir, "dist", "index.js");
   console.log(chalk.dim("Add this to your MCP client config:"));
   console.log();
-  console.log(
-    chalk.yellow.bold(
-      "--- Claude Desktop / Claude Chat (claude_desktop_config.json) ---"
-    )
-  );
-  console.log(`
-{
+  console.log(`{
   "mcpServers": {
     "coding-friend-learn": {
-      "command": "node",
-      "args": ["${serverPath}", "${docsDir}"]
+      "command": "npx",
+      "args": [
+        "-y",
+        "coding-friend-cli",
+        "mcp-serve-learn",
+        "${docsDir}"
+      ]
     }
   }
 }`);
   console.log();
-  console.log(chalk.yellow.bold("--- Generic MCP client ---"));
-  console.log(`
-Server command: node ${serverPath} ${docsDir}
-Transport: stdio`);
-  console.log();
-  console.log(chalk.yellow.bold("--- Available tools ---"));
-  console.log();
-  console.log(chalk.cyan.bold("Read:"));
-  console.log(
-    `  ${chalk.white("list-categories")}    ${chalk.dim("List all categories with doc counts")}`
-  );
-  console.log(
-    `  ${chalk.white("list-docs")}          ${chalk.dim("List docs, filter by category/tag")}`
-  );
-  console.log(
-    `  ${chalk.white("read-doc")}           ${chalk.dim("Read full content of a doc")}`
-  );
-  console.log(
-    `  ${chalk.white("search-docs")}        ${chalk.dim("Full-text search across all docs")}`
-  );
-  console.log(
-    `  ${chalk.white("get-review-list")}    ${chalk.dim("Docs that need review")}`
-  );
-  console.log();
-  console.log(chalk.cyan.bold("Write:"));
-  console.log(
-    `  ${chalk.white("create-doc")}         ${chalk.dim("Create new learning doc")}`
-  );
-  console.log(
-    `  ${chalk.white("update-doc")}         ${chalk.dim("Append content or update tags")}`
-  );
-  console.log(
-    `  ${chalk.white("improve-doc")}        ${chalk.dim("Get improvement suggestions")}`
-  );
-  console.log(
-    `  ${chalk.white("track-knowledge")}    ${chalk.dim("Record understanding level (remembered/needs-review/new)")}`
+  log.dim(
+    "Available tools & resources: https://cf.dinhanhthi.com/docs/cli/cf-mcp/"
   );
   console.log();
   printMemoryMcp();
@@ -147,12 +110,11 @@ function printMemoryMcp() {
     return;
   }
   ensureMemoryBuilt(mcpDir);
-  const serverPath = join(mcpDir, "dist", "index.js");
   console.log();
   printBanner("\u{1F9E0} Memory MCP", { color: chalk.magenta });
   log.info(`Memory dir: ${chalk.cyan(memoryDir)}`);
   console.log();
-  printMemoryMcpConfig(serverPath, memoryDir);
+  printMemoryMcpConfig(memoryDir);
 }
 export {
   detectMemoryMcpState,

package/dist/mcp-serve-learn-UNW6VH5M.js

@@ -0,0 +1,59 @@
+import {
+  getLibPath
+} from "./chunk-RZRT7NGT.js";
+import {
+  runWithStderr
+} from "./chunk-EVGXUDX4.js";
+import {
+  log
+} from "./chunk-NREZK463.js";
+
+// src/commands/mcp-serve-learn.ts
+import { spawn } from "child_process";
+import { existsSync, statSync } from "fs";
+import { join } from "path";
+function ensureLearnBuilt(mcpDir) {
+  if (!existsSync(join(mcpDir, "node_modules"))) {
+    log.step("Installing learn server dependencies (one-time setup)...");
+    const result = runWithStderr("npm", ["install"], { cwd: mcpDir });
+    if (result.exitCode !== 0) {
+      log.error("Failed to install dependencies");
+      if (result.stderr) log.error(result.stderr);
+      process.exit(1);
+    }
+    log.success("Done.");
+  }
+  if (!existsSync(join(mcpDir, "dist"))) {
+    log.step("Building learn server...");
+    const result = runWithStderr("npm", ["run", "build"], { cwd: mcpDir });
+    if (result.exitCode !== 0) {
+      log.error("Failed to build learn server");
+      if (result.stderr) log.error(result.stderr);
+      process.exit(1);
+    }
+    log.success("Done.");
+  }
+}
+async function mcpServeLearnCommand(docsDir) {
+  if (!existsSync(docsDir) || !statSync(docsDir).isDirectory()) {
+    log.error(`Docs directory not found: ${docsDir}`);
+    process.exit(1);
+    return;
+  }
+  const mcpDir = getLibPath("learn-mcp");
+  ensureLearnBuilt(mcpDir);
+  const serverPath = join(mcpDir, "dist", "index.js");
+  const child = spawn("node", [serverPath, docsDir], {
+    stdio: "inherit"
+  });
+  child.on("error", (err) => {
+    log.error(`Failed to start learn MCP server: ${err.message}`);
+    process.exit(1);
+  });
+  child.on("exit", (code) => {
+    process.exit(code ?? 0);
+  });
+}
+export {
+  mcpServeLearnCommand
+};

package/dist/{memory-2ZD4WU3S.js → memory-FZMACIGE.js}

@@ -13,14 +13,14 @@ import {
   memoryStatusCommand,
   memoryStopDaemonCommand,
   printMemoryMcpConfig
-} from "./chunk-355AR2X5.js";
-import "./chunk-5W7ZOVDU.js";
-import "./chunk-GTX6I57V.js";
+} from "./chunk-G2P43ZK2.js";
+import "./chunk-NZKIYVIK.js";
+import "./chunk-LK6HFD35.js";
 import "./chunk-RZRT7NGT.js";
-import "./chunk-DHH6SRXV.js";
-import "./chunk-HPNRQYLM.js";
-import "./chunk-EVGXUDX4.js";
+import "./chunk-OYPOADCX.js";
+import "./chunk-Z5Q533UG.js";
 import "./chunk-TWKNGPBO.js";
+import "./chunk-EVGXUDX4.js";
 import "./chunk-NREZK463.js";
 import "./chunk-5UVDWG5L.js";
 export {

package/dist/{permission-C5R3LMZQ.js → permission-DNW7DE24.js}

@@ -3,8 +3,7 @@ import {
   formatScopeLabel,
   getMergedValue,
   getScopeLabel
-} from "./chunk-HPNRQYLM.js";
-import "./chunk-EVGXUDX4.js";
+} from "./chunk-Z5Q533UG.js";
 import {
   claudeLocalSettingsPath,
   claudeProjectSettingsPath,
@@ -12,6 +11,7 @@ import {
   globalConfigPath,
   localConfigPath
 } from "./chunk-TWKNGPBO.js";
+import "./chunk-EVGXUDX4.js";
 import {
   log,
   printBanner

package/dist/{session-FMC2MG6C.js → session-RHXTVNRU.js}

@@ -1,7 +1,7 @@
 import {
   loadConfig
-} from "./chunk-GTX6I57V.js";
-import "./chunk-DHH6SRXV.js";
+} from "./chunk-LK6HFD35.js";
+import "./chunk-OYPOADCX.js";
 import {
   claudeSessionDir,
   encodeProjectPath,

package/dist/{status-FU5GR3MP.js → status-V2A7RSSM.js}

@@ -1,6 +1,6 @@
 import {
   resolveMemoryDir
-} from "./chunk-GTX6I57V.js";
+} from "./chunk-LK6HFD35.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
@@ -9,24 +9,24 @@ import {
   getLatestCliVersion,
   getLatestVersion,
   semverCompare
-} from "./chunk-4IUUWBZG.js";
+} from "./chunk-UGTNIFBH.js";
 import {
   getInstalledVersion
-} from "./chunk-LXZ47XCD.js";
-import "./chunk-DHH6SRXV.js";
+} from "./chunk-XOHLBLN2.js";
+import "./chunk-OYPOADCX.js";
 import "./chunk-DMJCO6LJ.js";
 import {
   detectPluginScope,
   isPluginDisabled
 } from "./chunk-R6HDMRYL.js";
-import "./chunk-HPNRQYLM.js";
-import "./chunk-EVGXUDX4.js";
+import "./chunk-Z5Q533UG.js";
 import {
   claudeSettingsPath,
   devStatePath,
   globalConfigPath,
   localConfigPath
 } from "./chunk-TWKNGPBO.js";
+import "./chunk-EVGXUDX4.js";
 import "./chunk-NREZK463.js";
 import {
   getExistingRules

package/dist/{statusline-5X7FZGRU.js → statusline-MLLKBHHR.js}

@@ -8,14 +8,14 @@ import {
   saveStatuslineConfig,
   selectStatuslineComponents,
   writeStatuslineSettings
-} from "./chunk-LXZ47XCD.js";
+} from "./chunk-XOHLBLN2.js";
 import {
   ALL_COMPONENT_IDS
-} from "./chunk-DHH6SRXV.js";
+} from "./chunk-OYPOADCX.js";
+import "./chunk-TWKNGPBO.js";
 import {
   commandExists
 } from "./chunk-EVGXUDX4.js";
-import "./chunk-TWKNGPBO.js";
 import {
   log,
   printBanner

package/dist/{uninstall-BOVKPNYN.js → uninstall-6ZJRS2H4.js}

@@ -8,11 +8,7 @@ import {
 } from "./chunk-R6HDMRYL.js";
 import {
   resolveScope
-} from "./chunk-HPNRQYLM.js";
-import {
-  commandExists,
-  run
-} from "./chunk-EVGXUDX4.js";
+} from "./chunk-Z5Q533UG.js";
 import {
   claudeSettingsPath,
   devStatePath,
@@ -21,6 +17,10 @@ import {
   marketplaceClonePath,
   memoryDepsDir
 } from "./chunk-TWKNGPBO.js";
+import {
+  commandExists,
+  run
+} from "./chunk-EVGXUDX4.js";
 import {
   log,
   printBanner

package/dist/{update-JBCG4CY2.js → update-G5HZINBK.js}

@@ -4,13 +4,13 @@ import {
   getLatestVersion,
   semverCompare,
   updateCommand
-} from "./chunk-4IUUWBZG.js";
-import "./chunk-LXZ47XCD.js";
-import "./chunk-DHH6SRXV.js";
+} from "./chunk-UGTNIFBH.js";
+import "./chunk-XOHLBLN2.js";
+import "./chunk-OYPOADCX.js";
 import "./chunk-DMJCO6LJ.js";
-import "./chunk-HPNRQYLM.js";
-import "./chunk-EVGXUDX4.js";
+import "./chunk-Z5Q533UG.js";
 import "./chunk-TWKNGPBO.js";
+import "./chunk-EVGXUDX4.js";
 import "./chunk-NREZK463.js";
 import "./chunk-5UVDWG5L.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-friend-cli",
-  "version": "1.32.1",
+  "version": "1.33.0",
   "description": "CLI for coding-friend — host learning docs, setup MCP server, initialize projects",
   "type": "module",
   "bin": {

package/dist/{chunk-HPNRQYLM.js → chunk-Z5Q533UG.js}

@@ -1,10 +1,10 @@
-import {
-  run
-} from "./chunk-EVGXUDX4.js";
 import {
   globalConfigPath,
   localConfigPath
 } from "./chunk-TWKNGPBO.js";
+import {
+  run
+} from "./chunk-EVGXUDX4.js";
 import {
   log
 } from "./chunk-NREZK463.js";

package/dist/{update-check-BPCQ25AR.js → update-check-5SCD2JR2.js}

@@ -1,9 +1,9 @@
-import {
-  run
-} from "./chunk-EVGXUDX4.js";
 import {
   globalConfigDir
 } from "./chunk-TWKNGPBO.js";
+import {
+  run
+} from "./chunk-EVGXUDX4.js";
 import {
   log
 } from "./chunk-NREZK463.js";