coding-friend-cli 1.1.1 → 1.2.1

package/README.md

@@ -28,6 +28,11 @@ cf update            # Update plugin + CLI + statusline
 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
+cf dev on [path]     # Switch to local plugin source for development
+cf dev off           # Switch back to remote marketplace
+cf dev status        # Show current dev mode (local or remote)
+cf dev sync          # Sync local changes to cache (no version bump needed)
+cf dev restart       # Reinstall local dev plugin (off + on)
 cf help              # Show all commands
 ```
 
@@ -46,6 +51,7 @@ Now `cf` is available globally, pointing to your local source. After making chan
 
 ```bash
 npm run build       # Rebuild (no need to re-link)
+npm run watch       # Auto-rebuild on file changes
 ```
 
 For development without rebuilding:
@@ -60,17 +66,49 @@ To unlink when done:
 npm unlink -g coding-friend-cli
 ```
 
+To check if `cf` is pointing to the local plugin source:
+
+```bash
+npm ls -g coding-friend-cli
+# Result:
+# /Users/thi/.nvm/versions/node/v22.21.1/lib
+#└── coding-friend-cli@1.1.1 -> ./../../../../../git/coding-friend/cli
+```
+
+### Running tests
+
+Tests are written with [Vitest](https://vitest.dev/) and live in `src/lib/__tests__/`.
+
+```bash
+cd cli
+
+# Run all tests once
+npm test
+
+# Watch mode (re-runs on file changes)
+npm run test:watch
+```
+
+Current coverage: `lib/json.ts`, `lib/paths.ts`, `lib/exec.ts`.
+
 ## Publish CLI to npm
 
+Publishing is automated via GitHub Actions (`.github/workflows/publish-cli.yml`). Push a tag with the `cli-v*` prefix to trigger it:
+
+```bash
+# Bump version in cli/package.json first, then tag and push
+git tag cli-v1.2.3
+git push origin cli-v1.2.3
+```
+
+The workflow will build, bundle, and publish to npm automatically (with provenance), then create a GitHub Release with the changelog for that version.
+
+**Manual publish (if needed):**
+
 ```bash
-# From the root of coding-friend project
 cd cli
 npm login              # Login if not already
 npm publish            # Build + bundle + publish
-
-# To bump a version
-npm version patch # 1.0.1 -> 1.0.2
-npm version minor # 1.0.1 -> 1.1.0
 ```
 
 `prepublishOnly` runs automatically: builds TypeScript → `dist/` and bundles libs from `lib/`.
@@ -81,4 +119,4 @@ npm version minor # 1.0.1 -> 1.1.0
 
 ## License
 
-MIT
+MIT

package/dist/{chunk-AQXTNLQD.js → chunk-6OI37OZX.js}

@@ -28,6 +28,12 @@ function pluginCachePath() {
     "coding-friend"
   );
 }
+function devStatePath() {
+  return join(homedir(), ".coding-friend", "dev-state.json");
+}
+function knownMarketplacesPath() {
+  return join(homedir(), ".claude", "plugins", "known_marketplaces.json");
+}
 
 export {
   resolvePath,
@@ -35,5 +41,7 @@ export {
   globalConfigPath,
   claudeSettingsPath,
   installedPluginsPath,
-  pluginCachePath
+  pluginCachePath,
+  devStatePath,
+  knownMarketplacesPath
 };

package/dist/chunk-CSF4FAHL.js

@@ -0,0 +1,129 @@
+import {
+  log
+} from "./chunk-6DUFTBTO.js";
+
+// src/lib/shell-completion.ts
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+var MARKER_START = "# >>> coding-friend CLI completion >>>";
+var MARKER_END = "# <<< coding-friend CLI completion <<<";
+var BASH_BLOCK = `
+
+${MARKER_START}
+_cf_completions() {
+  local cur="\${COMP_WORDS[COMP_CWORD]}"
+  local prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  local commands="init host mcp statusline update dev"
+
+  # Subcommands for 'dev'
+  if [[ "\${COMP_WORDS[1]}" == "dev" && \${COMP_CWORD} -eq 2 ]]; then
+    COMPREPLY=($(compgen -W "on off status restart sync" -- "$cur"))
+    return
+  fi
+
+  # Path completion for 'dev on'
+  if [[ "\${COMP_WORDS[1]}" == "dev" && "$prev" == "on" ]]; then
+    COMPREPLY=($(compgen -d -- "$cur"))
+    return
+  fi
+
+  COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+}
+complete -o default -F _cf_completions cf
+${MARKER_END}
+`;
+var ZSH_BLOCK = `
+
+${MARKER_START}
+_cf() {
+  local -a commands
+  commands=(
+    'init:Initialize coding-friend in current project'
+    'host:Build and serve learning docs as a static website'
+    'mcp:Setup MCP server for learning docs'
+    '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'
+  )
+
+  if (( CURRENT == 2 )); then
+    _describe 'command' commands
+  elif (( CURRENT == 3 )) && [[ "\${words[2]}" == "dev" ]]; then
+    local -a subcommands
+    subcommands=(
+      'on:Switch to local plugin source'
+      'off:Switch back to remote marketplace'
+      'status:Show current dev mode'
+      'restart:Restart dev mode (re-apply local plugin)'
+      'sync:Sync local plugin files without restarting'
+    )
+    _describe 'subcommand' subcommands
+  elif (( CURRENT == 4 )) && [[ "\${words[2]}" == "dev" && "\${words[3]}" == "on" ]]; then
+    _path_files -/
+  fi
+}
+compdef _cf cf
+${MARKER_END}
+`;
+function getShellRcPath() {
+  const shell = process.env.SHELL ?? "";
+  if (shell.includes("zsh")) return `${homedir()}/.zshrc`;
+  return `${homedir()}/.bashrc`;
+}
+function getRcName(rcPath) {
+  return rcPath.endsWith(".zshrc") ? ".zshrc" : ".bashrc";
+}
+function isZsh(rcPath) {
+  return rcPath.endsWith(".zshrc");
+}
+function hasShellCompletion() {
+  const rcPath = getShellRcPath();
+  if (!existsSync(rcPath)) return false;
+  return readFileSync(rcPath, "utf-8").includes(MARKER_START);
+}
+function extractExistingBlock(content) {
+  const startIdx = content.indexOf(MARKER_START);
+  const endIdx = content.indexOf(MARKER_END);
+  if (startIdx === -1 || endIdx === -1) return null;
+  return content.slice(startIdx, endIdx + MARKER_END.length);
+}
+function replaceBlock(content, newBlock) {
+  const startIdx = content.indexOf(MARKER_START);
+  const endIdx = content.indexOf(MARKER_END);
+  let sliceStart = startIdx;
+  while (sliceStart > 0 && content[sliceStart - 1] === "\n") sliceStart--;
+  return content.slice(0, sliceStart) + newBlock + content.slice(endIdx + MARKER_END.length);
+}
+function ensureShellCompletion(opts) {
+  const rcPath = getShellRcPath();
+  const rcName = getRcName(rcPath);
+  const newBlock = isZsh(rcPath) ? ZSH_BLOCK : BASH_BLOCK;
+  if (hasShellCompletion()) {
+    const content = readFileSync(rcPath, "utf-8");
+    const existing = extractExistingBlock(content);
+    const expectedBlock = newBlock.trim();
+    if (existing && existing.trim() === expectedBlock) {
+      if (!opts?.silent)
+        log.dim(`Tab completion already up-to-date in ~/${rcName}`);
+      return false;
+    }
+    const updated = replaceBlock(content, newBlock);
+    writeFileSync(rcPath, updated, "utf-8");
+    if (!opts?.silent) {
+      log.success(`Tab completion updated in ~/${rcName}`);
+      log.dim(`Run \`source ~/${rcName}\` or open a new terminal to activate.`);
+    }
+    return true;
+  }
+  appendFileSync(rcPath, newBlock);
+  if (!opts?.silent) {
+    log.success(`Tab completion added to ~/${rcName}`);
+    log.dim(`Run \`source ~/${rcName}\` or open a new terminal to activate.`);
+  }
+  return true;
+}
+
+export {
+  hasShellCompletion,
+  ensureShellCompletion
+};

package/dist/{chunk-KZT4AFDW.js → chunk-Q4DKU5IG.js}

@@ -2,7 +2,7 @@ import {
   globalConfigPath,
   localConfigPath,
   resolvePath
-} from "./chunk-AQXTNLQD.js";
+} from "./chunk-6OI37OZX.js";
 import {
   readJson
 } from "./chunk-IUTXHCP7.js";
@@ -29,12 +29,10 @@ import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 var __dirname = dirname(fileURLToPath(import.meta.url));
 function getLibPath(name) {
-  const bundled = join(__dirname, "..", "..", "lib", name);
-  if (existsSync(bundled)) return bundled;
-  const sibling = join(__dirname, "..", "..", "..", "lib", name);
-  if (existsSync(sibling)) return sibling;
+  const libDir = join(__dirname, "..", "..", "lib", name);
+  if (existsSync(libDir)) return libDir;
   throw new Error(
-    `Could not find lib/${name}. Ensure it exists in the CLI package or repo.`
+    `Could not find lib/${name}. Ensure it exists in the CLI package.`
   );
 }
 

package/dist/dev-MAAWPWML.js

@@ -0,0 +1,290 @@
+import {
+  commandExists,
+  run
+} from "./chunk-UFGNO6CW.js";
+import {
+  devStatePath,
+  installedPluginsPath,
+  knownMarketplacesPath,
+  pluginCachePath
+} from "./chunk-6OI37OZX.js";
+import {
+  log
+} from "./chunk-6DUFTBTO.js";
+import {
+  readJson,
+  writeJson
+} from "./chunk-IUTXHCP7.js";
+
+// src/commands/dev.ts
+import {
+  existsSync,
+  unlinkSync,
+  readdirSync,
+  statSync,
+  mkdirSync,
+  copyFileSync
+} from "fs";
+import { resolve, join } from "path";
+import chalk from "chalk";
+var REMOTE_URL = "https://github.com/dinhanhthi/coding-friend.git";
+var MARKETPLACE_NAME = "coding-friend-marketplace";
+var PLUGIN_NAME = "coding-friend";
+var PLUGIN_ID = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
+function getDevState() {
+  return readJson(devStatePath());
+}
+function isPluginInstalled() {
+  const data = readJson(installedPluginsPath());
+  if (!data) return false;
+  const plugins = data.plugins ?? data;
+  return Object.keys(plugins).some((k) => k.includes(PLUGIN_NAME));
+}
+function isMarketplaceRegistered() {
+  const data = readJson(knownMarketplacesPath());
+  if (!data) return false;
+  return MARKETPLACE_NAME in data;
+}
+function ensureClaude() {
+  if (!commandExists("claude")) {
+    log.error(
+      "Claude CLI not found. Install it first: https://docs.anthropic.com/en/docs/claude-code"
+    );
+    return false;
+  }
+  return true;
+}
+function runClaude(args, label) {
+  log.step(label);
+  const result = run("claude", args);
+  if (result === null) {
+    log.error(`Failed: claude ${args.join(" ")}`);
+    return false;
+  }
+  return true;
+}
+async function devOnCommand(path) {
+  const state = getDevState();
+  if (state) {
+    log.warn(`Dev mode is already ON (local: ${chalk.cyan(state.localPath)})`);
+    log.dim(`Run ${chalk.bold("cf dev off")} first to switch back.`);
+    return;
+  }
+  if (!ensureClaude()) return;
+  const localPath = resolve(path || process.cwd());
+  if (!existsSync(resolve(localPath, "plugin", ".claude-plugin", "plugin.json"))) {
+    log.error(`No plugin/.claude-plugin/plugin.json found at ${localPath}`);
+    log.dim("Make sure you point to the coding-friend repo root.");
+    return;
+  }
+  console.log(`
+=== ${chalk.green("Switching to local dev mode")} ===
+`);
+  log.info(`Local path: ${chalk.cyan(localPath)}`);
+  if (isPluginInstalled()) {
+    if (!runClaude(
+      ["plugin", "uninstall", PLUGIN_ID],
+      "Uninstalling remote plugin..."
+    )) {
+      run("claude", ["plugin", "uninstall", PLUGIN_NAME]);
+    }
+  }
+  if (isMarketplaceRegistered()) {
+    runClaude(
+      ["plugin", "marketplace", "remove", MARKETPLACE_NAME],
+      "Removing remote marketplace..."
+    );
+  }
+  if (!runClaude(
+    ["plugin", "marketplace", "add", localPath],
+    "Adding local marketplace..."
+  )) {
+    log.error("Failed to add local marketplace. Aborting.");
+    return;
+  }
+  if (!runClaude(
+    ["plugin", "install", PLUGIN_ID],
+    "Installing plugin from local source..."
+  )) {
+    if (!runClaude(["plugin", "install", PLUGIN_NAME], "Retrying install...")) {
+      log.error("Failed to install local plugin.");
+      return;
+    }
+  }
+  const devState = {
+    localPath,
+    savedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  writeJson(devStatePath(), devState);
+  console.log();
+  log.success(
+    `Dev mode ${chalk.green("ON")} \u2014 using local plugin from ${chalk.cyan(localPath)}`
+  );
+  log.dim("Restart Claude Code to see changes.");
+}
+async function devOffCommand() {
+  const state = getDevState();
+  if (!state) {
+    log.info("Dev mode is already OFF (using remote marketplace).");
+    return;
+  }
+  if (!ensureClaude()) return;
+  console.log(
+    `
+=== ${chalk.yellow("Switching back to remote marketplace")} ===
+`
+  );
+  if (isPluginInstalled()) {
+    if (!runClaude(
+      ["plugin", "uninstall", PLUGIN_ID],
+      "Uninstalling local plugin..."
+    )) {
+      run("claude", ["plugin", "uninstall", PLUGIN_NAME]);
+    }
+  }
+  if (isMarketplaceRegistered()) {
+    runClaude(
+      ["plugin", "marketplace", "remove", MARKETPLACE_NAME],
+      "Removing local marketplace..."
+    );
+  }
+  if (!runClaude(
+    ["plugin", "marketplace", "add", REMOTE_URL],
+    "Adding remote marketplace..."
+  )) {
+    log.error("Failed to add remote marketplace.");
+    return;
+  }
+  if (!runClaude(
+    ["plugin", "install", PLUGIN_ID],
+    "Installing plugin from remote..."
+  )) {
+    if (!runClaude(["plugin", "install", PLUGIN_NAME], "Retrying install...")) {
+      log.error("Failed to install remote plugin.");
+      return;
+    }
+  }
+  try {
+    unlinkSync(devStatePath());
+  } catch {
+  }
+  console.log();
+  log.success(`Dev mode ${chalk.yellow("OFF")} \u2014 using remote marketplace.`);
+  log.dim("Restart Claude Code to see changes.");
+}
+function getMarketplaceSource() {
+  const data = readJson(
+    knownMarketplacesPath()
+  );
+  if (!data || !(MARKETPLACE_NAME in data)) return null;
+  const entry = data[MARKETPLACE_NAME];
+  const src = entry.source;
+  if (!src) return null;
+  if (src.source === "directory" && src.path) {
+    return { type: "local", location: src.path };
+  }
+  if (src.source === "github" && src.repo) {
+    return { type: "remote", location: src.repo };
+  }
+  return null;
+}
+function copyDirRecursive(src, dest, fileCount = { n: 0 }) {
+  if (!existsSync(dest)) mkdirSync(dest, { recursive: true });
+  for (const entry of readdirSync(src)) {
+    const srcPath = join(src, entry);
+    const destPath = join(dest, entry);
+    if (statSync(srcPath).isDirectory()) {
+      copyDirRecursive(srcPath, destPath, fileCount);
+    } else {
+      copyFileSync(srcPath, destPath);
+      fileCount.n++;
+    }
+  }
+}
+async function devSyncCommand() {
+  const state = getDevState();
+  if (!state) {
+    log.error("Dev mode is OFF. Run `cf dev on <path>` first.");
+    return;
+  }
+  const localPath = state.localPath;
+  const pluginSrcDir = join(localPath, "plugin");
+  if (!existsSync(pluginSrcDir)) {
+    log.error(
+      `No plugin/ directory found at ${localPath}. Make sure you point to the coding-friend repo root.`
+    );
+    return;
+  }
+  const cacheBase = pluginCachePath();
+  let cacheVersionDir = null;
+  if (existsSync(cacheBase)) {
+    const versions = readdirSync(cacheBase).filter(
+      (v) => statSync(join(cacheBase, v)).isDirectory()
+    );
+    if (versions.length > 0) {
+      cacheVersionDir = join(
+        cacheBase,
+        versions.sort((a, b) => {
+          return statSync(join(cacheBase, b)).mtimeMs - statSync(join(cacheBase, a)).mtimeMs;
+        })[0]
+      );
+    }
+  }
+  if (!cacheVersionDir) {
+    log.error(
+      "No cached plugin version found. Run `cf dev off && cf dev on` first."
+    );
+    return;
+  }
+  const shortDest = cacheVersionDir.replace(process.env.HOME ?? "", "~");
+  log.step(`Syncing ${chalk.cyan(pluginSrcDir)} \u2192 ${chalk.dim(shortDest)}`);
+  const fileCount = { n: 0 };
+  copyDirRecursive(pluginSrcDir, cacheVersionDir, fileCount);
+  log.success(
+    `Synced ${chalk.green(fileCount.n)} files. Restart Claude Code to apply changes.`
+  );
+}
+async function devRestartCommand(path) {
+  const state = getDevState();
+  if (!ensureClaude()) return;
+  const localPath = path ?? state?.localPath;
+  console.log(`
+=== ${chalk.cyan("Restarting dev mode")} ===
+`);
+  if (state) {
+    await devOffCommand();
+    console.log();
+  } else {
+    log.info("Dev mode was OFF \u2014 skipping off step.");
+  }
+  await devOnCommand(localPath);
+}
+async function devStatusCommand() {
+  const state = getDevState();
+  const source = getMarketplaceSource();
+  const installed = isPluginInstalled();
+  if (state) {
+    log.info(`Dev mode: ${chalk.green("ON")}`);
+    log.info(`Local path: ${chalk.cyan(state.localPath)}`);
+    log.dim(`Since: ${state.savedAt}`);
+  } else {
+    log.info(`Dev mode: ${chalk.yellow("OFF")}`);
+  }
+  console.log();
+  if (source) {
+    const label = source.type === "local" ? `${chalk.green("local")} \u2192 ${chalk.cyan(source.location)}` : `${chalk.blue("remote")} \u2192 ${source.location}`;
+    log.info(`Marketplace source: ${label}`);
+  } else {
+    log.warn(`Marketplace "${MARKETPLACE_NAME}" not registered.`);
+  }
+  log.info(
+    `Plugin installed: ${installed ? chalk.green("yes") : chalk.yellow("no")}`
+  );
+}
+export {
+  devOffCommand,
+  devOnCommand,
+  devRestartCommand,
+  devStatusCommand,
+  devSyncCommand
+};

package/dist/{host-JBTJCWM2.js → host-2WINWEW7.js}

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

package/dist/index.js

@@ -10,25 +10,63 @@ var pkg = JSON.parse(
   readFileSync(join(__dirname, "..", "package.json"), "utf-8")
 );
 var program = new Command();
-program.name("cf").description("coding-friend CLI \u2014 host learning docs, setup MCP, init projects").version(pkg.version, "-v, --version");
+program.name("cf").description(
+  "coding-friend CLI \u2014 host learning docs, setup MCP, init projects"
+).version(pkg.version, "-v, --version");
 program.command("init").description("Initialize coding-friend in current project").action(async () => {
-  const { initCommand } = await import("./init-E6CL3UZQ.js");
+  const { initCommand } = await import("./init-CTCDQKIQ.js");
   await initCommand();
 });
 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-JBTJCWM2.js");
+  const { hostCommand } = await import("./host-2WINWEW7.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-MWESK6UX.js");
+  const { mcpCommand } = await import("./mcp-43HCE2KD.js");
   await mcpCommand(path);
 });
 program.command("statusline").description("Setup coding-friend statusline in Claude Code").action(async () => {
-  const { statuslineCommand } = await import("./statusline-7D6YU5YM.js");
+  const { statuslineCommand } = await import("./statusline-ARI7I5YM.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").action(async (opts) => {
-  const { updateCommand } = await import("./update-IH3G4SN5.js");
+  const { updateCommand } = await import("./update-GGCBM7U4.js");
   await updateCommand(opts);
 });
+var dev = program.command("dev").description("Development mode commands");
+program.addHelpText(
+  "after",
+  `
+Dev subcommands:
+  dev on [path]       Switch to local plugin source
+  dev off             Switch back to remote marketplace
+  dev status          Show current dev mode
+  dev sync            Copy local source to plugin cache
+  dev restart [path]  Reinstall local dev plugin (off + on)`
+);
+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-MAAWPWML.js");
+  await devOnCommand(path);
+});
+dev.command("off").description("Switch back to remote marketplace").action(async () => {
+  const { devOffCommand } = await import("./dev-MAAWPWML.js");
+  await devOffCommand();
+});
+dev.command("status").description("Show current dev mode").action(async () => {
+  const { devStatusCommand } = await import("./dev-MAAWPWML.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-MAAWPWML.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-MAAWPWML.js");
+  await devRestartCommand(path);
+});
 program.parse();