coding-friend-cli 1.14.0 → 1.16.0

package/dist/{chunk-PYRGNY5P.js → chunk-D4EWPGBL.js}

@@ -116,6 +116,13 @@ function getMergedValue(key, globalCfg, localCfg) {
   if (localVal !== void 0) return localVal;
   return globalCfg ? globalCfg[key] : void 0;
 }
+function ensureDocsFolders(docsDir, subfolders) {
+  if (!existsSync(docsDir)) {
+    run("mkdir", ["-p", docsDir]);
+    log.success(`Created "${docsDir}"`);
+  }
+  createSubfolders(docsDir, subfolders);
+}
 function createSubfolders(docsDir, subfolders) {
   const created = [];
   for (const sub of subfolders) {
@@ -177,5 +184,6 @@ export {
   getScopeLabel,
   formatScopeLabel,
   getMergedValue,
+  ensureDocsFolders,
   applyDocsDirChange
 };

package/dist/{chunk-IZFUAIP3.js → chunk-QNLL3ZDF.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-KJUGTLPQ.js";
 import {
   resolveScope
-} from "./chunk-PYRGNY5P.js";
+} from "./chunk-D4EWPGBL.js";
 import {
   commandExists,
   run,
@@ -172,6 +172,19 @@ async function updateCommand(opts) {
               if (newVersion !== currentVersion) break;
               if (i < 2) sleepSync(1e3);
             }
+            if (newVersion === currentVersion) {
+              log.dim("Marketplace cache may be stale. Trying reinstall...");
+              const installArgs = [
+                "plugin",
+                "install",
+                "coding-friend@coding-friend-marketplace"
+              ];
+              if (scope) {
+                installArgs.push("--scope", scope);
+              }
+              run("claude", installArgs);
+              newVersion = getInstalledVersion();
+            }
             if (newVersion !== currentVersion) {
               log.success(`Plugin updated to ${chalk.green(`v${newVersion}`)}`);
             } else {

package/dist/{config-UQ742WPQ.js → config-AIZJJ5D2.js}

@@ -23,7 +23,7 @@ import {
   getScopeLabel,
   injectBackChoice,
   showConfigHint
-} from "./chunk-PYRGNY5P.js";
+} from "./chunk-D4EWPGBL.js";
 import {
   run
 } from "./chunk-X5WEODUD.js";

package/dist/{dev-X7OJPTTW.js → dev-WJ5QQ35B.js}

@@ -42,6 +42,16 @@ var PLUGIN_ID = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
 function getDevState() {
   return readJson(devStatePath());
 }
+function getLocalPluginVersion(localPath) {
+  const pluginJsonPath = resolve(
+    localPath,
+    "plugin",
+    ".claude-plugin",
+    "plugin.json"
+  );
+  const data = readJson(pluginJsonPath);
+  return data?.version ?? null;
+}
 function ensureClaude() {
   if (!commandExists("claude")) {
     log.error(
@@ -74,9 +84,13 @@ async function devOnCommand(path) {
     log.dim("Make sure you point to the coding-friend repo root.");
     return;
   }
-  console.log(`
-=== ${chalk.green("Switching to local dev mode")} ===
-`);
+  const version = getLocalPluginVersion(localPath);
+  const versionLabel = version ? ` ${chalk.dim(`(v${version})`)}` : "";
+  console.log(
+    `
+=== ${chalk.green("Switching to local dev mode")}${versionLabel} ===
+`
+  );
   log.info(`Local path: ${chalk.cyan(localPath)}`);
   if (isPluginInstalled()) {
     if (!runClaude(
@@ -117,7 +131,7 @@ async function devOnCommand(path) {
   ensureShellCompletion({ silent: true });
   console.log();
   log.success(
-    `Dev mode ${chalk.green("ON")} \u2014 using local plugin from ${chalk.cyan(localPath)}`
+    `Dev mode ${chalk.green("ON")} \u2014 using local plugin${versionLabel} from ${chalk.cyan(localPath)}`
   );
   log.dim("Restart Claude Code to see changes.");
 }
@@ -247,8 +261,10 @@ async function devReinstall(path, label) {
   const state = getDevState();
   if (!ensureClaude()) return;
   const localPath = path ?? state?.localPath;
+  const version = localPath ? getLocalPluginVersion(localPath) : null;
+  const versionLabel = version ? ` ${chalk.dim(`(v${version})`)}` : "";
   console.log(`
-=== ${chalk.cyan(label)} ===
+=== ${chalk.cyan(label)}${versionLabel} ===
 `);
   if (state) {
     await devOffCommand();

package/dist/{disable-AOZ7FLZD.js → disable-JDVOQNZG.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-YC6MBHCT.js";
 import {
   resolveScope
-} from "./chunk-PYRGNY5P.js";
+} from "./chunk-D4EWPGBL.js";
 import "./chunk-X5WEODUD.js";
 import "./chunk-RWUTFVRB.js";
 import {

package/dist/{enable-MJVTT3RU.js → enable-JBJ4Q2S7.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-YC6MBHCT.js";
 import {
   resolveScope
-} from "./chunk-PYRGNY5P.js";
+} from "./chunk-D4EWPGBL.js";
 import "./chunk-X5WEODUD.js";
 import "./chunk-RWUTFVRB.js";
 import {

package/dist/index.js

@@ -14,27 +14,27 @@ 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-YXZGP2MY.js");
+  const { installCommand } = await import("./install-I3GOS56Q.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-2IOZZERP.js");
+  const { uninstallCommand } = await import("./uninstall-JN5YIKKM.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-AOZ7FLZD.js");
+  const { disableCommand } = await import("./disable-JDVOQNZG.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-MJVTT3RU.js");
+  const { enableCommand } = await import("./enable-JBJ4Q2S7.js");
   await enableCommand(opts);
 });
 program.command("init").description("Initialize coding-friend in current project").action(async () => {
-  const { initCommand } = await import("./init-AHIEQ27W.js");
+  const { initCommand } = await import("./init-FZ3GG53E.js");
   await initCommand();
 });
 program.command("config").description("Manage Coding Friend configuration").action(async () => {
-  const { configCommand } = await import("./config-UQ742WPQ.js");
+  const { configCommand } = await import("./config-AIZJJ5D2.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) => {
@@ -54,7 +54,7 @@ program.command("statusline").description("Setup coding-friend statusline in Cla
   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-OADURRFT.js");
+  const { updateCommand } = await import("./update-OWS4IJTG.js");
   await updateCommand(opts);
 });
 var session = program.command("session").description("Save and load Claude Code sessions across machines");
@@ -89,35 +89,35 @@ 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-X7OJPTTW.js");
+  const { devOnCommand } = await import("./dev-WJ5QQ35B.js");
   await devOnCommand(path);
 });
 dev.command("off").description("Switch back to remote marketplace").action(async () => {
-  const { devOffCommand } = await import("./dev-X7OJPTTW.js");
+  const { devOffCommand } = await import("./dev-WJ5QQ35B.js");
   await devOffCommand();
 });
 dev.command("status").description("Show current dev mode").action(async () => {
-  const { devStatusCommand } = await import("./dev-X7OJPTTW.js");
+  const { devStatusCommand } = await import("./dev-WJ5QQ35B.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-X7OJPTTW.js");
+  const { devSyncCommand } = await import("./dev-WJ5QQ35B.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-X7OJPTTW.js");
+  const { devRestartCommand } = await import("./dev-WJ5QQ35B.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-X7OJPTTW.js");
+  const { devUpdateCommand } = await import("./dev-WJ5QQ35B.js");
   await devUpdateCommand(path);
 });
 program.parse();

package/dist/{init-AHIEQ27W.js → init-FZ3GG53E.js}

@@ -22,12 +22,13 @@ import {
   BACK,
   applyDocsDirChange,
   askScope,
+  ensureDocsFolders,
   formatScopeLabel,
   getMergedValue,
   getScopeLabel,
   injectBackChoice,
   showConfigHint
-} from "./chunk-PYRGNY5P.js";
+} from "./chunk-D4EWPGBL.js";
 import {
   commandExists,
   run
@@ -84,6 +85,75 @@ function isGitRepo() {
 function escapeRegExp(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
+function hasGitignoreBlock() {
+  if (!existsSync(".gitignore")) return false;
+  const content = readFileSync(".gitignore", "utf-8");
+  return content.includes(GITIGNORE_START) || content.includes("# coding-friend");
+}
+function paddedScopeLabel(scope) {
+  const label = formatScopeLabel(scope);
+  const visibleLen = scope.length + 2;
+  return label + " ".repeat(Math.max(1, 9 - visibleLen));
+}
+function printSetupStatus(globalCfg, localCfg, gitAvailable) {
+  const docsDir = getDocsDir(globalCfg, localCfg);
+  const subfolders = ["plans", "memory", "research", "learn", "sessions"];
+  const folderStatus = subfolders.map((sub) => ({
+    name: `${docsDir}/${sub}`,
+    exists: existsSync(`${docsDir}/${sub}`)
+  }));
+  const foldersReady = folderStatus.filter((f) => f.exists).length;
+  const missingFolders = subfolders.length - foldersReady;
+  const allFoldersDone = missingFolders === 0;
+  const countColor = allFoldersDone ? chalk.green : chalk.yellow;
+  console.log(
+    `  ${chalk.bold("Folders")} ${countColor(`(${foldersReady}/${subfolders.length})`)}:`
+  );
+  for (const f of folderStatus) {
+    const icon = f.exists ? chalk.green("\u2713") : chalk.red("\u2717");
+    const name = f.exists ? chalk.dim(f.name) : f.name;
+    console.log(`    ${icon} ${name}`);
+  }
+  console.log();
+  const configKeys = [
+    { key: "docsDir", label: "Docs folder" },
+    { key: "language", label: "Docs language" },
+    { key: "learn", label: "/cf-learn config" }
+  ];
+  let notLocalCount = 0;
+  let notConfiguredCount = 0;
+  console.log(`  ${chalk.bold("Settings")}:`);
+  for (const s of configKeys) {
+    const scope = getScopeLabel(s.key, globalCfg, localCfg);
+    const value = getMergedValue(s.key, globalCfg, localCfg);
+    const valueStr = value && typeof value === "string" ? ` (${chalk.dim(value)})` : "";
+    console.log(`    ${paddedScopeLabel(scope)}${s.label}${valueStr}`);
+    if (scope === "-") notConfiguredCount++;
+    if (scope === "-" || scope === "global") notLocalCount++;
+  }
+  const setupItems = [
+    {
+      label: ".gitignore",
+      done: !gitAvailable || hasGitignoreBlock(),
+      skipped: !gitAvailable
+    },
+    { label: "Shell completion", done: hasShellCompletion(), skipped: false },
+    { label: "Statusline", done: isStatuslineConfigured(), skipped: false }
+  ];
+  for (const item of setupItems) {
+    if (item.skipped) {
+      console.log(`    ${paddedScopeLabel("skip")}${item.label}`);
+    } else if (item.done) {
+      console.log(`    ${paddedScopeLabel("done")}${item.label}`);
+    } else {
+      console.log(`    ${paddedScopeLabel("-")}${item.label}`);
+      notConfiguredCount++;
+    }
+  }
+  console.log();
+  const allDone = allFoldersDone && notConfiguredCount === 0;
+  return { allDone, notLocalCount, notConfiguredCount, missingFolders };
+}
 function writeToScope(scope, data) {
   const targetPath = scope === "global" ? globalConfigPath() : localConfigPath();
   mergeJson(targetPath, data);
@@ -99,6 +169,27 @@ function handleBack(value) {
 function getDocsDir(globalCfg, localCfg) {
   return localCfg?.docsDir ?? globalCfg?.docsDir ?? DEFAULT_CONFIG.docsDir;
 }
+async function offerGlobalShortcut(globalDisplay) {
+  const choice = await select({
+    message: "How to configure?",
+    choices: injectBackChoice(
+      [
+        {
+          name: `Use global setting (${globalDisplay})`,
+          value: "use_global"
+        },
+        { name: "Configure manually", value: "configure" }
+      ],
+      "Cancel init"
+    )
+  });
+  handleBack(choice);
+  if (choice === "use_global") {
+    log.dim("Using global setting.");
+    return true;
+  }
+  return false;
+}
 async function stepDocsDir(globalCfg, localCfg) {
   const currentValue = getMergedValue("docsDir", globalCfg, localCfg);
   const scopeLabel = getScopeLabel("docsDir", globalCfg, localCfg);
@@ -106,6 +197,18 @@ async function stepDocsDir(globalCfg, localCfg) {
     `Docs folder name ${formatScopeLabel(scopeLabel)}${currentValue ? ` (${chalk.dim(currentValue)})` : ""}`,
     "Where plans, memory, research, and session docs are stored in your project."
   );
+  const globalValue = globalCfg?.docsDir;
+  if (globalValue && await offerGlobalShortcut(globalValue)) {
+    const DOCS_SUBFOLDERS2 = [
+      "plans",
+      "memory",
+      "research",
+      "learn",
+      "sessions"
+    ];
+    ensureDocsFolders(globalValue, DOCS_SUBFOLDERS2);
+    return;
+  }
   const value = await input({
     message: "Docs folder name:",
     default: currentValue ?? DEFAULT_CONFIG.docsDir,
@@ -126,11 +229,7 @@ async function stepDocsDir(globalCfg, localCfg) {
   writeToScope(scope, { docsDir: value });
 }
 async function stepGitignore(docsDir) {
-  const hasBlock = (() => {
-    if (!existsSync(".gitignore")) return false;
-    const content = readFileSync(".gitignore", "utf-8");
-    return content.includes(GITIGNORE_START) || content.includes("# coding-friend");
-  })();
+  const hasBlock = hasGitignoreBlock();
   if (hasBlock) {
     printStepHeader(
       `Configure .gitignore ${chalk.green("[done]")}`,
@@ -206,6 +305,8 @@ async function stepDocsLanguage(globalCfg, localCfg) {
     `Docs language ${formatScopeLabel(scopeLabel)}${currentValue ? ` (${chalk.dim(currentValue)})` : ""}`,
     "Skills like /cf-plan, /cf-ask, /cf-remember will write docs in this language."
   );
+  const globalValue = globalCfg?.language;
+  if (globalValue && await offerGlobalShortcut(globalValue)) return;
   const lang = await selectLanguage(
     "What language should generated docs be written in?"
   );
@@ -243,6 +344,25 @@ async function stepLearnConfig(globalCfg, localCfg, gitAvailable) {
     `/cf-learn config ${formatScopeLabel(scopeLabel)}`,
     "Controls where and how /cf-learn saves your learning notes."
   );
+  const globalLearn = globalCfg?.learn;
+  if (globalLearn) {
+    const parts = [
+      globalLearn.language || "en",
+      globalLearn.outputDir || `${docsDir}/learn`
+    ];
+    if (globalLearn.categories) {
+      parts.push(`${globalLearn.categories.length} categories`);
+    }
+    if (await offerGlobalShortcut(parts.join(", "))) {
+      const gOutputDir = globalLearn.outputDir || `${docsDir}/learn`;
+      const gIsExternal = !gOutputDir.startsWith(`${docsDir}/`);
+      return {
+        outputDir: gOutputDir,
+        autoCommit: globalLearn.autoCommit || false,
+        isExternal: gIsExternal
+      };
+    }
+  }
   const language = await selectLanguage(
     "What language should /cf-learn notes be written in?"
   );
@@ -472,20 +592,52 @@ async function initCommand() {
   }
   const globalCfg = readJson(globalConfigPath());
   const localCfg = readJson(localConfigPath());
-  console.log("Current configuration:");
-  const docsDirScope = getScopeLabel("docsDir", globalCfg, localCfg);
-  const docsDirVal = getMergedValue("docsDir", globalCfg, localCfg);
-  console.log(
-    `  ${formatScopeLabel(docsDirScope)}  docsDir${docsDirVal ? ` (${chalk.dim(docsDirVal)})` : ""}`
-  );
-  const langScope = getScopeLabel("language", globalCfg, localCfg);
-  const langVal = getMergedValue("language", globalCfg, localCfg);
-  console.log(
-    `  ${formatScopeLabel(langScope)}  Docs language${langVal ? ` (${chalk.dim(langVal)})` : ""}`
-  );
-  const learnScope = getScopeLabel("learn", globalCfg, localCfg);
-  console.log(`  ${formatScopeLabel(learnScope)}  /cf-learn config`);
+  console.log("Project status:");
   console.log();
+  const { allDone, notLocalCount, notConfiguredCount, missingFolders } = printSetupStatus(globalCfg, localCfg, gitAvailable);
+  if (allDone) {
+    if (notLocalCount > 0) {
+      console.log(
+        chalk.dim(
+          `  ${notLocalCount} setting(s) inherited from global config only.`
+        )
+      );
+      console.log();
+    }
+    log.success("All settings configured!");
+    console.log();
+    const proceed = await confirm({
+      message: "Modify settings?",
+      default: false
+    });
+    if (!proceed) {
+      log.dim("No changes. Run `cf init` anytime to reconfigure.");
+      return;
+    }
+  } else {
+    const parts = [];
+    if (missingFolders > 0) {
+      parts.push(`${missingFolders} folder(s) missing`);
+    }
+    if (notConfiguredCount > 0) {
+      parts.push(`${notConfiguredCount} setting(s) not configured`);
+    }
+    if (notLocalCount > 0) {
+      parts.push(`${notLocalCount} not set locally`);
+    }
+    if (parts.length > 0) {
+      console.log(`  ${chalk.yellow("\u26A0")} ${parts.join(" \xB7 ")}`);
+      console.log();
+    }
+    const proceed = await confirm({
+      message: "Run setup wizard?",
+      default: true
+    });
+    if (!proceed) {
+      log.dim("Init cancelled. Run `cf init` anytime to resume.");
+      return;
+    }
+  }
   await stepDocsDir(globalCfg, localCfg);
   const updatedGlobal = readJson(globalConfigPath());
   const updatedLocal = readJson(localConfigPath());

package/dist/{install-YXZGP2MY.js → install-I3GOS56Q.js}

@@ -1,7 +1,7 @@
 import {
   getLatestVersion,
   semverCompare
-} from "./chunk-IZFUAIP3.js";
+} from "./chunk-QNLL3ZDF.js";
 import {
   enableMarketplaceAutoUpdate,
   isMarketplaceRegistered,
@@ -16,7 +16,7 @@ import {
 } from "./chunk-KJUGTLPQ.js";
 import {
   resolveScope
-} from "./chunk-PYRGNY5P.js";
+} from "./chunk-D4EWPGBL.js";
 import {
   commandExists,
   run

package/dist/{uninstall-2IOZZERP.js → uninstall-JN5YIKKM.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-KJUGTLPQ.js";
 import {
   resolveScope
-} from "./chunk-PYRGNY5P.js";
+} from "./chunk-D4EWPGBL.js";
 import {
   commandExists,
   run

package/dist/{update-OADURRFT.js → update-OWS4IJTG.js}

@@ -2,11 +2,11 @@ import {
   getLatestVersion,
   semverCompare,
   updateCommand
-} from "./chunk-IZFUAIP3.js";
+} from "./chunk-QNLL3ZDF.js";
 import "./chunk-ORACWEDN.js";
 import "./chunk-POC2WHU2.js";
 import "./chunk-KJUGTLPQ.js";
-import "./chunk-PYRGNY5P.js";
+import "./chunk-D4EWPGBL.js";
 import "./chunk-X5WEODUD.js";
 import "./chunk-RWUTFVRB.js";
 import "./chunk-W5CD7WTX.js";

package/lib/learn-host/CHANGELOG.md

@@ -2,7 +2,6 @@
 
 ## v0.2.1 (2026-03-05)
 
-- Add package manager tabs (npm, yarn, pnpm) to website ([#72e9e05](https://github.com/dinhanhthi/coding-friend/commit/72e9e05))
 - Fix TOC heading text stripping markdown links from slug generation ([#9a8fb5c](https://github.com/dinhanhthi/coding-friend/commit/9a8fb5c))
 - Decorate inline codes for TOC ([#573d7b0](https://github.com/dinhanhthi/coding-friend/commit/573d7b0))
 

package/package.json

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