coding-friend-cli 1.18.0 → 1.20.0

package/README.md

@@ -5,8 +5,26 @@ CLI companion for the [coding-friend](https://github.com/dinhanhthi/coding-frien
 ## Requirements
 
 - Node.js >= 18
+- npm (included with Node.js, but on some Linux distros you may need to install it separately)
 - The [coding-friend plugin](https://github.com/dinhanhthi/coding-friend) installed in Claude Code
 
+### Additional requirements for `cf memory init`
+
+The memory system's Tier 1 (SQLite) uses native Node.js modules that require compilation. On **Linux** (Ubuntu/Debian), install the following system packages before running `cf memory init`:
+
+```bash
+sudo apt update
+sudo apt install -y build-essential python3
+```
+
+On **macOS**, install Xcode Command Line Tools:
+
+```bash
+xcode-select --install
+```
+
+Without these, `cf memory init` will fail when installing SQLite dependencies (`better-sqlite3`, `sqlite-vec`). If you don't need Tier 1, you can choose the **lite** (Tier 2) or **markdown** (Tier 3) tier during init — these have no native dependencies.
+
 ## Install
 
 ```bash
@@ -55,6 +73,8 @@ cf permission --project    # Save to project-level settings (.claude/settings.lo
 cf permission --all --user # Apply all recommended permissions to user settings
 cf statusline        # Setup coding-friend statusline
 cf update               # Update plugin + CLI + statusline
+                        # 💡 If update fails, open Claude Code (`claude`) and run:
+                        #    /plugins → Installed → coding-friend → Update now → /reload-plugins
 cf update --cli         # Update only the CLI (npm package)
 cf update --plugin      # Update only the Claude Code plugin
 cf update --statusline  # Update only the statusline
@@ -76,8 +96,11 @@ cf memory rm --prune        # Remove orphaned projects (source dir missing or 0
 cf memory start-daemon  # Start memory daemon (enables Tier 2 search)
 cf memory stop-daemon   # Stop memory daemon
 cf memory rebuild    # Rebuild search index from markdown files
-cf memory init       # Initialize SQLite backend (Tier 1) and import memories
+cf memory init       # Initialize memory system (interactive wizard)
+cf memory config     # Configure memory system settings
 cf memory mcp        # Show MCP server config for clients
+cf status            # Show comprehensive Coding Friend status
+                     # (versions, plugin, memory, config)
 cf session save      # Save current Claude Code session to docs/sessions/
 cf session load      # Load a saved session from docs/sessions/
 cf help              # Show all commands

package/dist/{chunk-YC6MBHCT.js → chunk-JFGLNTZI.js}

@@ -66,6 +66,18 @@ function enableMarketplaceAutoUpdate() {
     return false;
   }
 }
+function detectPluginScope() {
+  const scopeOrder = ["local", "project", "user"];
+  for (const scope of scopeOrder) {
+    const settings = readJson(
+      settingsPathForScope(scope)
+    );
+    if (!settings) continue;
+    const enabled = settings.enabledPlugins;
+    if (enabled && PLUGIN_ID in enabled) return scope;
+  }
+  return "user";
+}
 function setPluginEnabled(scope, enabled) {
   const filePath = settingsPathForScope(scope);
   const settings = readJson(filePath) ?? {};
@@ -89,5 +101,6 @@ export {
   isMarketplaceRegistered,
   isPluginDisabled,
   enableMarketplaceAutoUpdate,
+  detectPluginScope,
   setPluginEnabled
 };

package/dist/{chunk-VUAUAO2R.js → chunk-NEQZP5D4.js}

@@ -21,7 +21,7 @@ ${MARKER_START}
 _cf_completions() {
   local cur="\${COMP_WORDS[COMP_CWORD]}"
   local prev="\${COMP_WORDS[COMP_CWORD-1]}"
-  local commands="install uninstall disable enable init config host mcp memory permission statusline update dev session"
+  local commands="install uninstall disable enable init config host mcp memory permission statusline update status dev session"
   local scope_flags="--user --global --project --local"
   local update_flags="--cli --plugin --statusline --user --global --project --local"
 
@@ -33,7 +33,7 @@ _cf_completions() {
 
   # Subcommands for 'memory'
   if [[ "\${COMP_WORDS[1]}" == "memory" && \${COMP_CWORD} -eq 2 ]]; then
-    COMPREPLY=($(compgen -W "status search list rm init start-daemon stop-daemon rebuild mcp" -- "$cur"))
+    COMPREPLY=($(compgen -W "status search list rm init config start-daemon stop-daemon rebuild mcp" -- "$cur"))
     return
   fi
 
@@ -88,6 +88,7 @@ var ZSH_FUNCTION_BODY = `_cf() {
     'statusline:Setup coding-friend statusline in Claude Code'
     'update:Update coding-friend plugin and refresh statusline'
     'dev:Switch between local and remote plugin for development'
+    'status:Show comprehensive Coding Friend status'
     'session:Save and load Claude Code sessions across machines'
   )
 
@@ -142,7 +143,8 @@ var ZSH_FUNCTION_BODY = `_cf() {
       'search:Search memories by query'
       'list:List memories (--projects for all DBs)'
       'rm:Remove a project database'
-      'init:Initialize Tier 1 (SQLite + Hybrid Search)'
+      'init:Initialize memory system (interactive wizard)'
+      'config:Configure memory system settings'
       'start-daemon:Start the memory daemon (Tier 2)'
       'stop-daemon:Stop the memory daemon'
       'rebuild:Rebuild the daemon search index'
@@ -185,6 +187,7 @@ complete -c cf -n "__fish_use_subcommand" -a permission -d "Manage Claude Code p
 complete -c cf -n "__fish_use_subcommand" -a statusline -d "Setup coding-friend statusline in Claude Code"
 complete -c cf -n "__fish_use_subcommand" -a update -d "Update coding-friend plugin and refresh statusline"
 complete -c cf -n "__fish_use_subcommand" -a dev -d "Switch between local and remote plugin for development"
+complete -c cf -n "__fish_use_subcommand" -a status -d "Show comprehensive Coding Friend status"
 complete -c cf -n "__fish_use_subcommand" -a session -d "Save and load Claude Code sessions across machines"
 # Scope flags for install/uninstall/disable/enable
 complete -c cf -n "__fish_seen_subcommand_from install uninstall disable enable" -l user -d "User scope (all projects)"
@@ -215,7 +218,8 @@ complete -c cf -n "__fish_seen_subcommand_from memory" -a status -d "Show memory
 complete -c cf -n "__fish_seen_subcommand_from memory" -a search -d "Search memories by query"
 complete -c cf -n "__fish_seen_subcommand_from memory" -a list -d "List memories (--projects for all DBs)"
 complete -c cf -n "__fish_seen_subcommand_from memory" -a rm -d "Remove a project database"
-complete -c cf -n "__fish_seen_subcommand_from memory" -a init -d "Initialize Tier 1 (SQLite + Hybrid Search)"
+complete -c cf -n "__fish_seen_subcommand_from memory" -a init -d "Initialize memory system (interactive wizard)"
+complete -c cf -n "__fish_seen_subcommand_from memory" -a config -d "Configure memory system settings"
 complete -c cf -n "__fish_seen_subcommand_from memory" -a start-daemon -d "Start the memory daemon (Tier 2)"
 complete -c cf -n "__fish_seen_subcommand_from memory" -a stop-daemon -d "Stop the memory daemon"
 complete -c cf -n "__fish_seen_subcommand_from memory" -a rebuild -d "Rebuild the daemon search index"
@@ -229,9 +233,9 @@ var POWERSHELL_BLOCK = `
 ${MARKER_START}
 Register-ArgumentCompleter -Native -CommandName cf -ScriptBlock {
   param($wordToComplete, $commandAst, $cursorPosition)
-  $commands = @('install','uninstall','disable','enable','init','config','host','mcp','memory','permission','statusline','update','dev','session')
+  $commands = @('install','uninstall','disable','enable','init','config','host','mcp','memory','permission','statusline','update','status','dev','session')
   $devSubcommands = @('on','off','status','restart','sync','update')
-  $memorySubcommands = @('status','search','list','rm','init','start-daemon','stop-daemon','rebuild','mcp')
+  $memorySubcommands = @('status','search','list','rm','init','config','start-daemon','stop-daemon','rebuild','mcp')
   $sessionSubcommands = @('save','load')
   $scopeFlags = @('--user','--global','--project','--local')
   $updateFlags = @('--cli','--plugin','--statusline','--user','--global','--project','--local')

package/dist/{chunk-A427XMWE.js → chunk-PHQK2MMO.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-ORACWEDN.js";
 import {
   ensureShellCompletion
-} from "./chunk-VUAUAO2R.js";
+} from "./chunk-NEQZP5D4.js";
 import {
   resolveScope
 } from "./chunk-C5LYVVEI.js";
@@ -198,7 +198,7 @@ async function updateCommand(opts) {
                 log.dim(`stderr: ${result.stderr}`);
               }
               log.dim(
-                "Try manually: claude plugin update coding-friend@coding-friend-marketplace"
+                "Try manually in Claude Code: /plugins \u2192 Installed \u2192 coding-friend \u2192 Update now \u2192 /reload-plugins"
               );
             }
           }
@@ -255,6 +255,8 @@ async function updateCommand(opts) {
 
 export {
   semverCompare,
+  getCliVersion,
+  getLatestCliVersion,
   getLatestVersion,
   updateCommand
 };

package/dist/{chunk-KTX4MGMR.js → chunk-QMD7P67N.js}

@@ -9,10 +9,33 @@ import {
 } from "./chunk-RWUTFVRB.js";
 
 // src/lib/config.ts
+function deepMerge(base, override) {
+  const result = { ...base };
+  for (const key of Object.keys(override)) {
+    const baseVal = result[key];
+    const overVal = override[key];
+    if (baseVal && overVal && typeof baseVal === "object" && typeof overVal === "object" && !Array.isArray(baseVal) && !Array.isArray(overVal)) {
+      result[key] = deepMerge(
+        baseVal,
+        overVal
+      );
+    } else {
+      result[key] = overVal;
+    }
+  }
+  return result;
+}
 function loadConfig() {
   const global = readJson(globalConfigPath());
   const local = readJson(localConfigPath());
-  return { ...DEFAULT_CONFIG, ...global, ...local };
+  const base = deepMerge(
+    DEFAULT_CONFIG,
+    global ?? {}
+  );
+  return deepMerge(
+    base,
+    local ?? {}
+  );
 }
 function resolveDocsDir(explicitPath) {
   if (explicitPath) {
@@ -33,9 +56,6 @@ function resolveMemoryDir(explicitPath) {
     return resolvePath(explicitPath);
   }
   const config = loadConfig();
-  if (config.memory?.docsDir) {
-    return resolvePath(config.memory.docsDir);
-  }
   if (config.docsDir) {
     return resolvePath(`${config.docsDir}/memory`);
   }

package/dist/chunk-WEMDLEK5.js

@@ -0,0 +1,331 @@
+import {
+  getLibPath
+} from "./chunk-RZRT7NGT.js";
+import {
+  BACK,
+  askScope,
+  formatScopeLabel,
+  injectBackChoice
+} from "./chunk-C5LYVVEI.js";
+import {
+  globalConfigPath,
+  localConfigPath,
+  mergeJson,
+  readJson
+} from "./chunk-RWUTFVRB.js";
+import {
+  log
+} from "./chunk-W5CD7WTX.js";
+
+// src/lib/memory-prompts.ts
+import { confirm, input, select } from "@inquirer/prompts";
+import { join } from "path";
+function getMemoryFieldScope(field, globalCfg, localCfg) {
+  const globalSection = globalCfg?.memory;
+  const localSection = localCfg?.memory;
+  const inGlobal = globalSection?.[field] !== void 0;
+  const inLocal = localSection?.[field] !== void 0;
+  if (inGlobal && inLocal) return "both";
+  if (inGlobal) return "global";
+  if (inLocal) return "local";
+  return "-";
+}
+function getMergedMemoryValue(field, globalCfg, localCfg) {
+  const localSection = localCfg?.memory;
+  if (localSection?.[field] !== void 0) return localSection[field];
+  const globalSection = globalCfg?.memory;
+  return globalSection?.[field];
+}
+function writeMemoryField(scope, field, value) {
+  const targetPath = scope === "global" ? globalConfigPath() : localConfigPath();
+  const existingConfig = readJson(targetPath);
+  const existingSection = existingConfig?.memory ?? {};
+  const updated = { ...existingSection, [field]: value };
+  mergeJson(targetPath, { memory: updated });
+  log.success(`Saved to ${targetPath}`);
+}
+async function editMemoryTier(globalCfg, localCfg) {
+  const currentValue = getMergedMemoryValue("tier", globalCfg, localCfg);
+  if (currentValue) {
+    log.dim(`Current: ${currentValue}`);
+  }
+  const choice = await select({
+    message: "Memory search tier:",
+    choices: injectBackChoice(
+      [
+        {
+          name: "auto \u2014 detect best available (recommended)",
+          value: "auto"
+        },
+        {
+          name: "full \u2014 SQLite + FTS5 + vector embeddings (Tier 1)",
+          value: "full"
+        },
+        {
+          name: "lite \u2014 MiniSearch daemon, in-memory BM25 + fuzzy (Tier 2)",
+          value: "lite"
+        },
+        {
+          name: "markdown \u2014 file-based substring search (Tier 3)",
+          value: "markdown"
+        }
+      ],
+      "Back"
+    )
+  });
+  if (choice === BACK) return;
+  const scope = await askScope();
+  if (scope === "back") return;
+  writeMemoryField(scope, "tier", choice);
+}
+async function editMemoryAutoCapture(globalCfg, localCfg) {
+  const currentValue = getMergedMemoryValue(
+    "autoCapture",
+    globalCfg,
+    localCfg
+  );
+  if (currentValue !== void 0) {
+    log.dim(`Current: ${currentValue}`);
+  }
+  const value = await confirm({
+    message: "Auto-capture session context to memory on PreCompact (context window compression)?",
+    default: currentValue ?? false
+  });
+  const scope = await askScope();
+  if (scope === "back") return;
+  writeMemoryField(scope, "autoCapture", value);
+}
+async function editMemoryAutoStart(globalCfg, localCfg) {
+  const currentValue = getMergedMemoryValue(
+    "autoStart",
+    globalCfg,
+    localCfg
+  );
+  if (currentValue !== void 0) {
+    log.dim(`Current: ${currentValue}`);
+  }
+  const value = await confirm({
+    message: "Auto-start memory daemon when MCP server connects?",
+    default: currentValue ?? false
+  });
+  const scope = await askScope();
+  if (scope === "back") return;
+  writeMemoryField(scope, "autoStart", value);
+}
+async function editMemoryEmbedding(globalCfg, localCfg) {
+  const currentEmbedding = getMergedMemoryValue(
+    "embedding",
+    globalCfg,
+    localCfg
+  );
+  if (currentEmbedding) {
+    const parts = [`provider: ${currentEmbedding.provider ?? "transformers"}`];
+    if (currentEmbedding.model) parts.push(`model: ${currentEmbedding.model}`);
+    if (currentEmbedding.ollamaUrl)
+      parts.push(`url: ${currentEmbedding.ollamaUrl}`);
+    log.dim(`Current: ${parts.join(", ")}`);
+  }
+  const provider = await select({
+    message: "Embedding provider:",
+    choices: injectBackChoice(
+      [
+        {
+          name: "transformers \u2014 Transformers.js, runs in-process (no external deps)",
+          value: "transformers"
+        },
+        {
+          name: "ollama \u2014 Local Ollama server (faster, GPU support, wider model selection)",
+          value: "ollama"
+        }
+      ],
+      "Back"
+    )
+  });
+  if (provider === BACK) return;
+  let model;
+  let ollamaUrl;
+  if (provider === "ollama") {
+    ollamaUrl = await input({
+      message: "Ollama server URL:",
+      default: currentEmbedding?.ollamaUrl ?? "http://localhost:11434"
+    });
+    if (ollamaUrl === "http://localhost:11434") ollamaUrl = void 0;
+    const mcpDir = getLibPath("cf-memory");
+    try {
+      const { isOllamaRunning, hasOllamaEmbeddingModel } = await import(join(mcpDir, "dist/lib/ollama.js"));
+      const url = ollamaUrl ?? "http://localhost:11434";
+      const running = await isOllamaRunning(url);
+      if (!running) {
+        console.log();
+        log.warn("Ollama is not running at " + url);
+        log.dim(
+          "Install Ollama: https://ollama.ai \xB7 Docs: https://cf.dinhanhthi.com/cli/cf-memory"
+        );
+        console.log();
+        const fallback = await confirm({
+          message: "Fall back to Transformers.js instead?",
+          default: true
+        });
+        if (fallback) {
+          const scope2 = await askScope();
+          if (scope2 === "back") return;
+          writeMemoryField(scope2, "embedding", { provider: "transformers" });
+          return;
+        }
+      } else {
+        model = await input({
+          message: "Ollama model name:",
+          default: currentEmbedding?.model ?? "all-minilm:l6-v2"
+        });
+        const hasModel = await hasOllamaEmbeddingModel(model, url);
+        if (!hasModel) {
+          console.log();
+          log.warn(`Model "${model}" not found in Ollama.`);
+          log.dim(`Pull it with: ollama pull ${model}`);
+          console.log();
+          const proceed = await confirm({
+            message: "Save this config anyway? (you can pull the model later)",
+            default: true
+          });
+          if (!proceed) return;
+        }
+      }
+    } catch {
+      model = await input({
+        message: "Ollama model name:",
+        default: currentEmbedding?.model ?? "all-minilm:l6-v2"
+      });
+    }
+  } else {
+    model = await input({
+      message: "Transformers.js model:",
+      default: currentEmbedding?.model ?? "Xenova/all-MiniLM-L6-v2"
+    });
+    if (model === "Xenova/all-MiniLM-L6-v2") model = void 0;
+  }
+  const scope = await askScope();
+  if (scope === "back") return;
+  const embedding = { provider };
+  if (model) embedding.model = model;
+  if (ollamaUrl) embedding.ollamaUrl = ollamaUrl;
+  writeMemoryField(scope, "embedding", embedding);
+}
+async function editMemoryDaemonTimeout(globalCfg, localCfg) {
+  const currentDaemon = getMergedMemoryValue("daemon", globalCfg, localCfg);
+  const currentMs = currentDaemon?.idleTimeout;
+  const currentMin = currentMs ? currentMs / 6e4 : void 0;
+  if (currentMin !== void 0) {
+    log.dim(`Current: ${currentMin} minutes`);
+  }
+  const value = await input({
+    message: "Daemon idle timeout (minutes):",
+    default: String(currentMin ?? 30),
+    validate: (val) => {
+      const n = Number(val);
+      if (isNaN(n) || n < 1) return "Must be a positive number";
+      return true;
+    }
+  });
+  const scope = await askScope();
+  if (scope === "back") return;
+  writeMemoryField(scope, "daemon", {
+    ...currentDaemon,
+    idleTimeout: Number(value) * 6e4
+  });
+}
+async function memoryConfigMenu(opts) {
+  while (true) {
+    const globalCfg = readJson(globalConfigPath());
+    const localCfg = readJson(localConfigPath());
+    const tierScope = getMemoryFieldScope("tier", globalCfg, localCfg);
+    const tierVal = getMergedMemoryValue("tier", globalCfg, localCfg);
+    const autoCaptureScope = getMemoryFieldScope(
+      "autoCapture",
+      globalCfg,
+      localCfg
+    );
+    const autoCaptureVal = getMergedMemoryValue(
+      "autoCapture",
+      globalCfg,
+      localCfg
+    );
+    const autoStartScope = getMemoryFieldScope(
+      "autoStart",
+      globalCfg,
+      localCfg
+    );
+    const autoStartVal = getMergedMemoryValue(
+      "autoStart",
+      globalCfg,
+      localCfg
+    );
+    const embeddingScope = getMemoryFieldScope(
+      "embedding",
+      globalCfg,
+      localCfg
+    );
+    const embeddingVal = getMergedMemoryValue(
+      "embedding",
+      globalCfg,
+      localCfg
+    );
+    const daemonScope = getMemoryFieldScope("daemon", globalCfg, localCfg);
+    const daemonVal = getMergedMemoryValue("daemon", globalCfg, localCfg);
+    const embeddingLabel = embeddingVal?.provider ? embeddingVal.model ? `${embeddingVal.model} (${embeddingVal.provider})` : embeddingVal.provider : "";
+    const choice = await select({
+      message: "Memory settings:",
+      choices: injectBackChoice(
+        [
+          {
+            name: `Tier ${formatScopeLabel(tierScope)}${tierVal ? ` (${tierVal})` : ""}`,
+            value: "tier"
+          },
+          {
+            name: `Auto-capture ${formatScopeLabel(autoCaptureScope)}${autoCaptureVal !== void 0 ? ` (${autoCaptureVal})` : ""}`,
+            value: "autoCapture"
+          },
+          {
+            name: `Auto-start daemon ${formatScopeLabel(autoStartScope)}${autoStartVal !== void 0 ? ` (${autoStartVal})` : ""}`,
+            value: "autoStart"
+          },
+          {
+            name: `Embedding ${formatScopeLabel(embeddingScope)}${embeddingLabel ? ` (${embeddingLabel})` : ""}`,
+            value: "embedding"
+          },
+          {
+            name: `Daemon timeout ${formatScopeLabel(daemonScope)}${daemonVal?.idleTimeout ? ` (${daemonVal.idleTimeout / 6e4}min)` : ""}`,
+            value: "daemon"
+          }
+        ],
+        opts?.exitLabel ?? "Back"
+      )
+    });
+    if (choice === BACK) return;
+    switch (choice) {
+      case "tier":
+        await editMemoryTier(globalCfg, localCfg);
+        break;
+      case "autoCapture":
+        await editMemoryAutoCapture(globalCfg, localCfg);
+        break;
+      case "autoStart":
+        await editMemoryAutoStart(globalCfg, localCfg);
+        break;
+      case "embedding":
+        await editMemoryEmbedding(globalCfg, localCfg);
+        break;
+      case "daemon":
+        await editMemoryDaemonTimeout(globalCfg, localCfg);
+        break;
+    }
+  }
+}
+
+export {
+  editMemoryTier,
+  editMemoryAutoCapture,
+  editMemoryAutoStart,
+  editMemoryEmbedding,
+  editMemoryDaemonTimeout,
+  memoryConfigMenu
+};