coding-friend-cli 1.27.2 → 1.28.0

package/README.md

@@ -147,19 +147,25 @@ npm ls -g coding-friend-cli
 
 ### Running tests
 
-Tests are written with [Vitest](https://vitest.dev/) and live in `src/lib/__tests__/`.
+Tests are written with [Vitest](https://vitest.dev/).
 
 ```bash
 cd cli
 
-# Run all tests once
+# Run all unit tests once
 npm test
 
 # Watch mode (re-runs on file changes)
 npm run test:watch
+
+# Run E2E tests (real CLI commands against temp directories)
+npm run test:e2e
+
+# Run E2E tests in Docker (isolated, no host pollution)
+cd e2e && docker compose up --build --abort-on-container-exit
 ```
 
-Current coverage: `lib/json.ts`, `lib/paths.ts`, `lib/exec.ts`.
+Unit tests live in `src/**/__tests__/` and use mocks. E2E tests live in `e2e/` and run actual CLI commands — see [`e2e/README.md`](e2e/README.md) for details.
 
 ## Publish CLI to npm
 

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

@@ -6,12 +6,16 @@ var STATUSLINE_COMPONENTS = [
   { id: "branch", label: "Git branch (\u2387 main)" },
   {
     id: "account",
-    label: "Account info \u2014 name, email & org (from ~/.claude.json)"
+    label: "Account info \u2014 name, email (from ~/.claude.json)"
   },
   { id: "context", label: "Context window usage (ctx 42%)" },
   {
     id: "rate_limit",
     label: "Rate limit \u2014 current & weekly usage (requires curl & jq)"
+  },
+  {
+    id: "task_agent",
+    label: "Task progress & active agent (Tasks: 2/5 | Agent: cf-reviewer)"
   }
 ];
 var ALL_COMPONENT_IDS = STATUSLINE_COMPONENTS.map((c) => c.id);

package/dist/{chunk-75IEE2OE.js → chunk-E7OY4UWW.js}

@@ -7,14 +7,14 @@ import {
   getMemoryMcpStatus,
   memoryConfigMenu,
   writeMemoryMcpEntry
-} from "./chunk-BX3DRKTU.js";
+} from "./chunk-XROT7L2F.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
 import {
   loadConfig,
   resolveMemoryDir
-} from "./chunk-2HQVNQB7.js";
+} from "./chunk-J4N2ODQ5.js";
 import {
   showConfigHint
 } from "./chunk-HPNRQYLM.js";

package/dist/chunk-J4N2ODQ5.js

@@ -0,0 +1,191 @@
+import {
+  DEFAULT_CONFIG
+} from "./chunk-DHH6SRXV.js";
+import {
+  globalConfigPath,
+  localConfigPath,
+  resolvePath
+} from "./chunk-TWKNGPBO.js";
+import {
+  log
+} from "./chunk-NREZK463.js";
+import {
+  readJson
+} from "./chunk-5UVDWG5L.js";
+
+// src/lib/config.ts
+import { z } from "zod";
+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;
+}
+var LearnCategorySchema = z.object({
+  name: z.string(),
+  description: z.string()
+});
+var LearnConfigSchema = z.object({
+  language: z.string().optional(),
+  outputDir: z.string().optional(),
+  categories: z.array(LearnCategorySchema).optional(),
+  autoCommit: z.boolean().optional(),
+  readmeIndex: z.union([z.boolean(), z.literal("per-category")]).optional()
+});
+var StatuslineComponentSchema = z.enum([
+  "version",
+  "folder",
+  "model",
+  "branch",
+  "account",
+  "context",
+  "rate_limit",
+  "task_agent"
+]);
+var StatuslineConfigSchema = z.object({
+  components: z.array(StatuslineComponentSchema).optional()
+});
+var MemoryConfigSchema = z.object({
+  tier: z.enum(["auto", "full", "lite", "markdown"]).optional(),
+  daemon: z.object({
+    idleTimeout: z.number().optional()
+  }).optional(),
+  embedding: z.object({
+    provider: z.enum(["transformers", "ollama"]).optional(),
+    model: z.string().optional(),
+    ollamaUrl: z.string().optional()
+  }).optional(),
+  autoCapture: z.boolean().optional(),
+  autoStart: z.boolean().optional()
+});
+var ConfigSchema = z.strictObject({
+  language: z.string().optional(),
+  docsDir: z.string().optional(),
+  learn: LearnConfigSchema.optional(),
+  statusline: StatuslineConfigSchema.optional(),
+  memory: MemoryConfigSchema.optional(),
+  autoApprove: z.boolean().optional()
+});
+var KNOWN_KEYS = [
+  "language",
+  "docsDir",
+  "learn",
+  "statusline",
+  "memory",
+  "autoApprove"
+];
+function suggestKey(unknown) {
+  let best = null;
+  let bestDist = Infinity;
+  for (const known of KNOWN_KEYS) {
+    const dist = levenshtein(unknown.toLowerCase(), known.toLowerCase());
+    if (dist < bestDist && dist <= 3) {
+      bestDist = dist;
+      best = known;
+    }
+  }
+  return best;
+}
+function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  const dp = Array.from(
+    { length: m + 1 },
+    () => Array(n + 1).fill(0)
+  );
+  for (let i = 0; i <= m; i++) dp[i][0] = i;
+  for (let j = 0; j <= n; j++) dp[0][j] = j;
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    }
+  }
+  return dp[m][n];
+}
+function validateConfig(merged) {
+  const result = ConfigSchema.safeParse(merged);
+  if (result.success) return result.data;
+  const sanitized = { ...merged };
+  for (const issue of result.error.issues) {
+    const pathStr = issue.path.join(".");
+    if (issue.code === "unrecognized_keys") {
+      const keys = issue.keys ?? [];
+      for (const key of keys) {
+        const suggestion = suggestKey(key);
+        const hint = suggestion ? ` Did you mean '${suggestion}'?` : "";
+        log.warn(`Unknown config key '${key}'.${hint}`);
+        delete sanitized[key];
+      }
+    } else {
+      log.warn(`Config: ${pathStr} \u2014 ${issue.message}. Using default.`);
+      stripPath(sanitized, issue.path);
+    }
+  }
+  return deepMerge(
+    DEFAULT_CONFIG,
+    sanitized
+  );
+}
+function stripPath(obj, path) {
+  if (path.length === 0) return;
+  let current = obj;
+  for (let i = 0; i < path.length - 1; i++) {
+    const key = String(path[i]);
+    if (current[key] && typeof current[key] === "object") {
+      current = current[key];
+    } else {
+      return;
+    }
+  }
+  delete current[String(path[path.length - 1])];
+}
+function loadConfig() {
+  const global = readJson(globalConfigPath());
+  const local = readJson(localConfigPath());
+  const base = deepMerge(
+    DEFAULT_CONFIG,
+    global ?? {}
+  );
+  const merged = deepMerge(base, local ?? {});
+  return validateConfig(merged);
+}
+function resolveDocsDir(explicitPath) {
+  if (explicitPath) {
+    return resolvePath(explicitPath);
+  }
+  const local = readJson(localConfigPath());
+  if (local?.learn?.outputDir) {
+    return resolvePath(local.learn.outputDir);
+  }
+  const global = readJson(globalConfigPath());
+  if (global?.learn?.outputDir) {
+    return resolvePath(global.learn.outputDir);
+  }
+  return resolvePath("docs/learn");
+}
+function resolveMemoryDir(explicitPath) {
+  if (explicitPath) {
+    return resolvePath(explicitPath);
+  }
+  const config = loadConfig();
+  if (config.docsDir) {
+    return resolvePath(`${config.docsDir}/memory`);
+  }
+  return resolvePath("docs/memory");
+}
+
+export {
+  loadConfig,
+  resolveDocsDir,
+  resolveMemoryDir
+};

package/dist/{chunk-YCWRBOB3.js → chunk-RGQGKOBH.js}

@@ -1,7 +1,7 @@
 import {
   ensureStatusline,
   getInstalledVersion
-} from "./chunk-GDZTU2Z4.js";
+} from "./chunk-XQ5KAXKL.js";
 import {
   ensureShellCompletion
 } from "./chunk-DMJCO6LJ.js";

package/dist/{chunk-GDZTU2Z4.js → chunk-XQ5KAXKL.js}

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

package/dist/{chunk-BX3DRKTU.js → chunk-XROT7L2F.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-RZRT7NGT.js";
 import {
   resolveMemoryDir
-} from "./chunk-2HQVNQB7.js";
+} from "./chunk-J4N2ODQ5.js";
 import {
   BACK,
   askScope,
@@ -222,16 +222,17 @@ async function editMemoryEmbedding(globalCfg, localCfg) {
 async function editMemoryDaemonTimeout(globalCfg, localCfg) {
   const currentDaemon = getMergedMemoryValue("daemon", globalCfg, localCfg);
   const currentMs = currentDaemon?.idleTimeout;
-  const currentMin = currentMs ? currentMs / 6e4 : void 0;
+  const currentMin = currentMs !== void 0 ? 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),
+    message: "Daemon idle timeout (minutes, 0 = no timeout):",
+    default: String(currentMin ?? 0),
     validate: (val) => {
       const n = Number(val);
-      if (isNaN(n) || n < 1) return "Must be a positive number";
+      if (isNaN(n) || n < 0)
+        return "Must be 0 (no timeout) or a positive number";
       return true;
     }
   });

package/dist/{config-N55LTJ76.js → config-U2WEZXF6.js}

@@ -1,19 +1,19 @@
 import {
   memoryConfigMenu
-} from "./chunk-BX3DRKTU.js";
+} from "./chunk-XROT7L2F.js";
 import "./chunk-RZRT7NGT.js";
-import "./chunk-2HQVNQB7.js";
+import "./chunk-J4N2ODQ5.js";
 import {
   findStatuslineHookPath,
   isStatuslineConfigured,
   saveStatuslineConfig,
   selectStatuslineComponents,
   writeStatuslineSettings
-} from "./chunk-GDZTU2Z4.js";
+} from "./chunk-XQ5KAXKL.js";
 import {
   ALL_COMPONENT_IDS,
   DEFAULT_CONFIG
-} from "./chunk-PRIH34UB.js";
+} from "./chunk-DHH6SRXV.js";
 import {
   ensureShellCompletion,
   hasShellCompletion,

package/dist/{dev-BSXR55PZ.js → dev-4OAJCQRQ.js}

@@ -1,7 +1,7 @@
 import {
   ensureStatusline
-} from "./chunk-GDZTU2Z4.js";
-import "./chunk-PRIH34UB.js";
+} from "./chunk-XQ5KAXKL.js";
+import "./chunk-DHH6SRXV.js";
 import {
   ensureShellCompletion
 } from "./chunk-DMJCO6LJ.js";
@@ -32,6 +32,7 @@ import {
   existsSync,
   unlinkSync,
   readdirSync,
+  readFileSync,
   statSync,
   mkdirSync,
   copyFileSync
@@ -255,11 +256,29 @@ async function devSyncCommand() {
   }
   const shortDest = cacheVersionDir.replace(homedir(), "~");
   log.step(`Syncing ${chalk.cyan(pluginSrcDir)} \u2192 ${chalk.dim(shortDest)}`);
+  const cachedHooksPath = join(cacheVersionDir, "hooks", "hooks.json");
+  const sourceHooksPath = join(pluginSrcDir, "hooks", "hooks.json");
+  let hooksEventsChanged = false;
+  try {
+    const cachedHooks = JSON.parse(readFileSync(cachedHooksPath, "utf-8"));
+    const sourceHooks = JSON.parse(readFileSync(sourceHooksPath, "utf-8"));
+    const cachedEvents = Object.keys(cachedHooks.hooks || {}).sort();
+    const sourceEvents = Object.keys(sourceHooks.hooks || {}).sort();
+    hooksEventsChanged = JSON.stringify(cachedEvents) !== JSON.stringify(sourceEvents);
+  } catch {
+  }
   const fileCount = { n: 0 };
   copyDirRecursive(pluginSrcDir, cacheVersionDir, fileCount);
-  log.success(
-    `Synced ${chalk.green(fileCount.n)} files. Restart Claude Code to apply changes.`
-  );
+  if (hooksEventsChanged) {
+    log.success(`Synced ${chalk.green(fileCount.n)} files.`);
+    log.warn(
+      `hooks.json event types changed. Run ${chalk.bold("cf dev restart")} for Claude Code to register the new hook events.`
+    );
+  } else {
+    log.success(
+      `Synced ${chalk.green(fileCount.n)} files. Restart Claude Code to apply changes.`
+    );
+  }
 }
 async function devReinstall(path, label) {
   const state = getDevState();
@@ -288,6 +307,11 @@ async function devStatusCommand() {
   if (state) {
     log.info(`Dev mode: ${chalk.green("ON")}`);
     log.info(`Local path: ${chalk.cyan(state.localPath)}`);
+    if (!existsSync(state.localPath)) {
+      log.warn(
+        `Dev mode path no longer exists: ${state.localPath}. Run 'cf host <new-path>' to update.`
+      );
+    }
     log.dim(`Since: ${state.savedAt}`);
   } else {
     log.info(`Dev mode: ${chalk.yellow("OFF")}`);

package/dist/guide-F2FLCDYO.js

@@ -0,0 +1,113 @@
+import {
+  devStatePath,
+  pluginCachePath
+} from "./chunk-TWKNGPBO.js";
+import {
+  log
+} from "./chunk-NREZK463.js";
+import {
+  readJson
+} from "./chunk-5UVDWG5L.js";
+
+// src/commands/guide.ts
+import { existsSync, mkdirSync, readdirSync, writeFileSync } from "fs";
+import { join, resolve } from "path";
+var GUIDE_TEMPLATE = `# Custom Guide for {{SKILL_NAME}}
+
+<!-- Sections are optional \u2014 include only the ones you need. -->
+<!-- This file is loaded automatically when the skill runs. -->
+
+## Before
+
+<!-- Steps to execute BEFORE the skill's first step. -->
+<!-- Example: run a linter, check prerequisites, set up context. -->
+
+## Rules
+
+<!-- Additional rules to apply THROUGHOUT all steps of the skill. -->
+<!-- Example: "always use TypeScript strict mode", "never modify tests in src/__tests__". -->
+
+## After
+
+<!-- Steps to execute AFTER the skill's final step. -->
+<!-- Example: run a formatter, update a changelog, notify a channel. -->
+`;
+function findPluginSkillsDir() {
+  const devState = readJson(devStatePath());
+  if (devState?.localPath) {
+    const dir = join(devState.localPath, "plugin", "skills");
+    if (existsSync(dir)) return dir;
+  }
+  const cachePath = pluginCachePath();
+  if (existsSync(cachePath)) {
+    try {
+      const versions = readdirSync(cachePath, { withFileTypes: true }).filter((e) => e.isDirectory() && /^\d/.test(e.name)).map((e) => e.name).sort((a, b) => b.localeCompare(a, void 0, { numeric: true }));
+      for (const ver of versions) {
+        const dir = join(cachePath, ver, "plugin", "skills");
+        if (existsSync(dir)) return dir;
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+function skillExists(skillsDir, skillName) {
+  return existsSync(join(skillsDir, skillName, "SKILL.md"));
+}
+function guideCreateCommand(skillName) {
+  if (!/^[a-z0-9-]+$/.test(skillName)) {
+    log.error(
+      `Invalid skill name "${skillName}". Use lowercase letters, numbers, and hyphens only.`
+    );
+    return;
+  }
+  const skillsDir = findPluginSkillsDir();
+  if (!skillsDir || !skillExists(skillsDir, skillName)) {
+    log.error(
+      `Skill "${skillName}" not found. Run "cf guide list" to see available skills.`
+    );
+    return;
+  }
+  const guideDir = resolve(".coding-friend", "skills", `${skillName}-custom`);
+  const guidePath = join(guideDir, "SKILL.md");
+  if (existsSync(guidePath)) {
+    log.warn(`Custom guide already exists: ${guidePath}`);
+    return;
+  }
+  mkdirSync(guideDir, { recursive: true });
+  writeFileSync(
+    guidePath,
+    GUIDE_TEMPLATE.replace(/\{\{SKILL_NAME\}\}/g, skillName)
+  );
+  log.success(`Created custom guide: ${guidePath}`);
+  log.dim("Edit the file to add your Before/Rules/After sections.");
+}
+function guideListCommand() {
+  const customDir = resolve(".coding-friend", "skills");
+  if (!existsSync(customDir)) {
+    log.dim(
+      "No custom guides found. Run `cf guide create <skill-name>` to create one."
+    );
+    return;
+  }
+  const entries = readdirSync(customDir, { withFileTypes: true }).filter(
+    (e) => e.isDirectory() && e.name.endsWith("-custom") && existsSync(join(customDir, e.name, "SKILL.md"))
+  ).map((e) => e.name.replace(/-custom$/, ""));
+  if (entries.length === 0) {
+    log.dim(
+      "No custom guides found. Run `cf guide create <skill-name>` to create one."
+    );
+    return;
+  }
+  const skillsDir = findPluginSkillsDir();
+  log.info(`Custom guides (${entries.length}):`);
+  for (const name of entries) {
+    const path = join(customDir, `${name}-custom`, "SKILL.md");
+    const exists = skillsDir != null && skillExists(skillsDir, name) ? "\u2714" : "\u26A0 skill not found";
+    log.info(`  ${name}  \u2192  ${path}  (${exists})`);
+  }
+}
+export {
+  guideCreateCommand,
+  guideListCommand
+};

package/dist/{host-JVLWYY5A.js → host-2KBOPER6.js}

@@ -3,8 +3,8 @@ import {
 } from "./chunk-RZRT7NGT.js";
 import {
   resolveDocsDir
-} from "./chunk-2HQVNQB7.js";
-import "./chunk-PRIH34UB.js";
+} from "./chunk-J4N2ODQ5.js";
+import "./chunk-DHH6SRXV.js";
 import {
   run,
   streamExec

package/dist/index.js

@@ -14,7 +14,7 @@ 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-G4XYNVL3.js");
+  const { installCommand } = await import("./install-XZC6UO54.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) => {
@@ -30,19 +30,19 @@ program.command("enable").description("Re-enable the Coding Friend plugin").opti
   await enableCommand(opts);
 });
 program.command("init").description("Initialize coding-friend in current project").action(async () => {
-  const { initCommand } = await import("./init-FM5D5CD2.js");
+  const { initCommand } = await import("./init-R5L2GAFV.js");
   await initCommand();
 });
 program.command("config").description("Manage Coding Friend configuration").action(async () => {
-  const { configCommand } = await import("./config-N55LTJ76.js");
+  const { configCommand } = await import("./config-U2WEZXF6.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-JVLWYY5A.js");
+  const { hostCommand } = await import("./host-2KBOPER6.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-DABSO5PE.js");
+  const { mcpCommand } = await import("./mcp-CNZLJ57B.js");
   await mcpCommand(path);
 });
 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(
@@ -53,15 +53,15 @@ program.command("permission").description("Manage Claude Code permission rules f
   await permissionCommand(opts);
 });
 program.command("statusline").description("Setup coding-friend statusline in Claude Code").action(async () => {
-  const { statuslineCommand } = await import("./statusline-CDGADB3C.js");
+  const { statuslineCommand } = await import("./statusline-RMTO4MQA.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-6M3YFHS6.js");
+  const { updateCommand } = await import("./update-HS6A2C5V.js");
   await updateCommand(opts);
 });
 program.command("status").description("Show comprehensive Coding Friend status").action(async () => {
-  const { statusCommand } = await import("./status-K7TBUAXT.js");
+  const { statusCommand } = await import("./status-JXUXVHRH.js");
   await statusCommand();
 });
 var session = program.command("session").description("Save and load Claude Code sessions across machines");
@@ -76,11 +76,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-VXYTI2C6.js");
+  const { sessionSaveCommand } = await import("./session-ZGNQKV4M.js");
   await sessionSaveCommand(opts);
 });
 session.command("load").description("Load a saved session from sync folder").action(async () => {
-  const { sessionLoadCommand } = await import("./session-VXYTI2C6.js");
+  const { sessionLoadCommand } = await import("./session-ZGNQKV4M.js");
   await sessionLoadCommand();
 });
 var memory = program.command("memory").description("AI memory system \u2014 store and search project knowledge");
@@ -100,43 +100,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-7Q5P7LIU.js");
+  const { memoryStatusCommand } = await import("./memory-KU2MOCPQ.js");
   await memoryStatusCommand();
 });
 memory.command("search").description("Search memories by query").argument("<query>", "search query").action(async (query) => {
-  const { memorySearchCommand } = await import("./memory-7Q5P7LIU.js");
+  const { memorySearchCommand } = await import("./memory-KU2MOCPQ.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-7Q5P7LIU.js");
+  const { memoryListCommand } = await import("./memory-KU2MOCPQ.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-7Q5P7LIU.js");
+  const { memoryInitCommand } = await import("./memory-KU2MOCPQ.js");
   await memoryInitCommand();
 });
 memory.command("config").description("Configure memory system settings").action(async () => {
-  const { memoryConfigCommand } = await import("./memory-7Q5P7LIU.js");
+  const { memoryConfigCommand } = await import("./memory-KU2MOCPQ.js");
   await memoryConfigCommand();
 });
 memory.command("start-daemon").description("Start the memory daemon (Tier 2 \u2014 MiniSearch)").action(async () => {
-  const { memoryStartDaemonCommand } = await import("./memory-7Q5P7LIU.js");
+  const { memoryStartDaemonCommand } = await import("./memory-KU2MOCPQ.js");
   await memoryStartDaemonCommand();
 });
 memory.command("stop-daemon").description("Stop the memory daemon").action(async () => {
-  const { memoryStopDaemonCommand } = await import("./memory-7Q5P7LIU.js");
+  const { memoryStopDaemonCommand } = await import("./memory-KU2MOCPQ.js");
   await memoryStopDaemonCommand();
 });
 memory.command("rebuild").description("Rebuild the daemon search index").action(async () => {
-  const { memoryRebuildCommand } = await import("./memory-7Q5P7LIU.js");
+  const { memoryRebuildCommand } = await import("./memory-KU2MOCPQ.js");
   await memoryRebuildCommand();
 });
 memory.command("mcp").description("Show MCP server setup instructions").action(async () => {
-  const { memoryMcpCommand } = await import("./memory-7Q5P7LIU.js");
+  const { memoryMcpCommand } = await import("./memory-KU2MOCPQ.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(
@@ -144,10 +144,19 @@ 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-7Q5P7LIU.js");
+    const { memoryRmCommand } = await import("./memory-KU2MOCPQ.js");
     await memoryRmCommand(opts);
   }
 );
+var guide = program.command("guide").description("Manage custom skill guides");
+guide.command("create").description("Create a custom guide for a skill").argument("<skill-name>", "skill to create guide for (e.g. cf-commit)").action(async (skillName) => {
+  const { guideCreateCommand } = await import("./guide-F2FLCDYO.js");
+  guideCreateCommand(skillName);
+});
+guide.command("list").description("List existing custom guides").action(async () => {
+  const { guideListCommand } = await import("./guide-F2FLCDYO.js");
+  guideListCommand();
+});
 var dev = program.command("dev").description("Development mode commands");
 program.addHelpText(
   "after",
@@ -161,35 +170,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-BSXR55PZ.js");
+  const { devOnCommand } = await import("./dev-4OAJCQRQ.js");
   await devOnCommand(path);
 });
 dev.command("off").description("Switch back to remote marketplace").action(async () => {
-  const { devOffCommand } = await import("./dev-BSXR55PZ.js");
+  const { devOffCommand } = await import("./dev-4OAJCQRQ.js");
   await devOffCommand();
 });
 dev.command("status").description("Show current dev mode").action(async () => {
-  const { devStatusCommand } = await import("./dev-BSXR55PZ.js");
+  const { devStatusCommand } = await import("./dev-4OAJCQRQ.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-BSXR55PZ.js");
+  const { devSyncCommand } = await import("./dev-4OAJCQRQ.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-BSXR55PZ.js");
+  const { devRestartCommand } = await import("./dev-4OAJCQRQ.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-BSXR55PZ.js");
+  const { devUpdateCommand } = await import("./dev-4OAJCQRQ.js");
   await devUpdateCommand(path);
 });
 program.hook("postAction", async () => {

package/dist/{init-FM5D5CD2.js → init-R5L2GAFV.js}

@@ -2,24 +2,24 @@ import {
   ensureMemoryBuilt,
   isMemoryInitialized,
   memoryInitWizard
-} from "./chunk-75IEE2OE.js";
+} from "./chunk-E7OY4UWW.js";
 import {
   memoryConfigMenu
-} from "./chunk-BX3DRKTU.js";
+} from "./chunk-XROT7L2F.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
-import "./chunk-2HQVNQB7.js";
+import "./chunk-J4N2ODQ5.js";
 import {
   findStatuslineHookPath,
   isStatuslineConfigured,
   saveStatuslineConfig,
   selectStatuslineComponents,
   writeStatuslineSettings
-} from "./chunk-GDZTU2Z4.js";
+} from "./chunk-XQ5KAXKL.js";
 import {
   DEFAULT_CONFIG
-} from "./chunk-PRIH34UB.js";
+} from "./chunk-DHH6SRXV.js";
 import {
   ensureShellCompletion,
   hasShellCompletion

package/dist/{install-G4XYNVL3.js → install-XZC6UO54.js}

@@ -1,11 +1,11 @@
 import {
   getLatestVersion,
   semverCompare
-} from "./chunk-YCWRBOB3.js";
+} from "./chunk-RGQGKOBH.js";
 import {
   getInstalledVersion
-} from "./chunk-GDZTU2Z4.js";
-import "./chunk-PRIH34UB.js";
+} from "./chunk-XQ5KAXKL.js";
+import "./chunk-DHH6SRXV.js";
 import {
   ensureShellCompletion
 } from "./chunk-DMJCO6LJ.js";

package/dist/{mcp-DABSO5PE.js → mcp-CNZLJ57B.js}

@@ -1,16 +1,16 @@
 import {
   ensureMemoryBuilt,
   printMemoryMcpConfig
-} from "./chunk-75IEE2OE.js";
-import "./chunk-BX3DRKTU.js";
+} from "./chunk-E7OY4UWW.js";
+import "./chunk-XROT7L2F.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
 import {
   resolveDocsDir,
   resolveMemoryDir
-} from "./chunk-2HQVNQB7.js";
-import "./chunk-PRIH34UB.js";
+} from "./chunk-J4N2ODQ5.js";
+import "./chunk-DHH6SRXV.js";
 import "./chunk-HPNRQYLM.js";
 import {
   run

package/dist/{memory-7Q5P7LIU.js → memory-KU2MOCPQ.js}

@@ -13,11 +13,11 @@ import {
   memoryStatusCommand,
   memoryStopDaemonCommand,
   printMemoryMcpConfig
-} from "./chunk-75IEE2OE.js";
-import "./chunk-BX3DRKTU.js";
+} from "./chunk-E7OY4UWW.js";
+import "./chunk-XROT7L2F.js";
 import "./chunk-RZRT7NGT.js";
-import "./chunk-2HQVNQB7.js";
-import "./chunk-PRIH34UB.js";
+import "./chunk-J4N2ODQ5.js";
+import "./chunk-DHH6SRXV.js";
 import "./chunk-HPNRQYLM.js";
 import "./chunk-EVGXUDX4.js";
 import "./chunk-TWKNGPBO.js";

package/dist/{session-VXYTI2C6.js → session-ZGNQKV4M.js}

@@ -1,7 +1,7 @@
 import {
   loadConfig
-} from "./chunk-2HQVNQB7.js";
-import "./chunk-PRIH34UB.js";
+} from "./chunk-J4N2ODQ5.js";
+import "./chunk-DHH6SRXV.js";
 import {
   claudeSessionDir,
   encodeProjectPath,

package/dist/{status-K7TBUAXT.js → status-JXUXVHRH.js}

@@ -3,17 +3,17 @@ import {
 } from "./chunk-RZRT7NGT.js";
 import {
   resolveMemoryDir
-} from "./chunk-2HQVNQB7.js";
+} from "./chunk-J4N2ODQ5.js";
 import {
   getCliVersion,
   getLatestCliVersion,
   getLatestVersion,
   semverCompare
-} from "./chunk-YCWRBOB3.js";
+} from "./chunk-RGQGKOBH.js";
 import {
   getInstalledVersion
-} from "./chunk-GDZTU2Z4.js";
-import "./chunk-PRIH34UB.js";
+} from "./chunk-XQ5KAXKL.js";
+import "./chunk-DHH6SRXV.js";
 import "./chunk-DMJCO6LJ.js";
 import {
   detectPluginScope,

package/dist/{statusline-CDGADB3C.js → statusline-RMTO4MQA.js}

@@ -4,10 +4,10 @@ import {
   saveStatuslineConfig,
   selectStatuslineComponents,
   writeStatuslineSettings
-} from "./chunk-GDZTU2Z4.js";
+} from "./chunk-XQ5KAXKL.js";
 import {
   ALL_COMPONENT_IDS
-} from "./chunk-PRIH34UB.js";
+} from "./chunk-DHH6SRXV.js";
 import {
   commandExists
 } from "./chunk-EVGXUDX4.js";

package/dist/{update-6M3YFHS6.js → update-HS6A2C5V.js}

@@ -4,9 +4,9 @@ import {
   getLatestVersion,
   semverCompare,
   updateCommand
-} from "./chunk-YCWRBOB3.js";
-import "./chunk-GDZTU2Z4.js";
-import "./chunk-PRIH34UB.js";
+} from "./chunk-RGQGKOBH.js";
+import "./chunk-XQ5KAXKL.js";
+import "./chunk-DHH6SRXV.js";
 import "./chunk-DMJCO6LJ.js";
 import "./chunk-HPNRQYLM.js";
 import "./chunk-EVGXUDX4.js";

package/lib/cf-memory/README.md

@@ -226,12 +226,12 @@ npm run test:watch    # Watch mode
 node dist/daemon/entry.js ./docs/memory
 
 # With idle timeout (ms) and tier
-node dist/daemon/entry.js ./docs/memory 1800000 --tier=lite
+node dist/daemon/entry.js ./docs/memory 0 --tier=lite
 ```
 
 The daemon runs a Hono HTTP server on a Unix Domain Socket at `~/.coding-friend/memory/daemon.sock`, with PID tracking at `~/.coding-friend/memory/daemon.pid`.
 
-**Auto-reconnect:** If the daemon dies (e.g., idle timeout expires), the `DaemonClient` automatically respawns it on the next request. This means mid-session daemon restarts are transparent — no manual intervention needed.
+**Auto-reconnect with retry:** If the daemon dies (e.g., crash or explicit stop), the `DaemonClient` automatically respawns it on the next request with up to 3 retry attempts (1-second delay between retries). If all retries fail, it falls back to Tier 3 (markdown grep). This means mid-session daemon restarts are transparent — no manual intervention needed.
 
 ### Lazy dependencies (Tier 1)
 
@@ -306,7 +306,7 @@ If these are missing, `cf memory init` will fail at the "Installing SQLite depen
 | ----------------------------- | ------------------------ | ------------------------------------------------- |
 | `MEMORY_DOCS_DIR`             | `./docs/memory`          | Path to memory storage directory                  |
 | `MEMORY_TIER`                 | `auto`                   | Force a tier: `auto`, `full`, `lite`, `markdown`  |
-| `MEMORY_DAEMON_IDLE_TIMEOUT`  | `1800000` (30 min)       | Daemon idle timeout in ms (`0` = never auto-stop) |
+| `MEMORY_DAEMON_IDLE_TIMEOUT`  | `0` (no timeout)         | Daemon idle timeout in ms (`0` = never auto-stop) |
 | `MEMORY_EMBEDDING_PROVIDER`   | `transformers`           | Embedding provider: `transformers` or `ollama`    |
 | `MEMORY_EMBEDDING_MODEL`      | (provider default)       | Embedding model name (e.g., `nomic-embed-text`)   |
 | `MEMORY_EMBEDDING_OLLAMA_URL` | `http://localhost:11434` | Ollama server URL                                 |

package/lib/cf-memory/src/__tests__/tier.test.ts

@@ -289,6 +289,65 @@ describe("createBackendForTier() with embeddingConfig", () => {
   });
 });
 
+describe("makeRespawn retry logic", () => {
+  it("retries up to 3 times before giving up", async () => {
+    const daemonProcess = await import("../daemon/process.js");
+
+    let attempts = 0;
+    const spawnSpy = vi
+      .spyOn(daemonProcess, "spawnDaemon")
+      .mockImplementation(async () => {
+        attempts++;
+        return null; // always fail
+      });
+    // Isolate from real daemon state on the host machine
+    const runningSpy = vi
+      .spyOn(daemonProcess, "isDaemonRunning")
+      .mockResolvedValue(false);
+
+    // Use createBackendForTier with "lite" to trigger respawn path
+    // The respawn callback wraps makeRespawn which calls spawnDaemon
+    // We need to get the respawn function indirectly
+    // Instead, test via the exported createRespawnWithRetry
+    const { createRespawnWithRetry } = await import("../lib/tier.js");
+    const respawn = createRespawnWithRetry(".", undefined, undefined);
+    const result = await respawn();
+
+    expect(result).toBe(false);
+    expect(attempts).toBe(3);
+
+    spawnSpy.mockRestore();
+    runningSpy.mockRestore();
+  });
+
+  it("succeeds on second attempt", async () => {
+    const daemonProcess = await import("../daemon/process.js");
+
+    let attempts = 0;
+    const spawnSpy = vi
+      .spyOn(daemonProcess, "spawnDaemon")
+      .mockImplementation(async () => {
+        attempts++;
+        if (attempts === 2) return { pid: 1234 };
+        return null;
+      });
+    // Isolate from real daemon state on the host machine
+    const runningSpy = vi
+      .spyOn(daemonProcess, "isDaemonRunning")
+      .mockResolvedValue(false);
+
+    const { createRespawnWithRetry } = await import("../lib/tier.js");
+    const respawn = createRespawnWithRetry(".", undefined, undefined);
+    const result = await respawn();
+
+    expect(result).toBe(true);
+    expect(attempts).toBe(2);
+
+    spawnSpy.mockRestore();
+    runningSpy.mockRestore();
+  });
+});
+
 describe("TIERS constant", () => {
   it("has all 3 tier definitions", () => {
     expect(Object.keys(TIERS)).toHaveLength(3);

package/lib/cf-memory/src/daemon/process.ts

@@ -6,7 +6,7 @@ import { getRequestListener } from "@hono/node-server";
 import { createDaemonApp } from "./server.js";
 import type { MemoryBackend } from "../lib/backend.js";
 
-const DEFAULT_IDLE_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+const DEFAULT_IDLE_TIMEOUT_MS = 0; // 0 = no timeout, run until explicitly stopped
 
 export interface DaemonPaths {
   socketPath: string;

package/lib/cf-memory/src/lib/tier.ts

@@ -50,17 +50,29 @@ export async function detectTier(configTier?: TierConfig): Promise<TierInfo> {
   return TIERS.markdown;
 }
 
-/** Build a respawn callback that DaemonClient can call when the daemon is gone. */
-function makeRespawn(
+const RESPAWN_MAX_RETRIES = 3;
+const RESPAWN_RETRY_DELAY_MS = 1000;
+
+/** Build a respawn callback with retry logic (up to 3 attempts). */
+export function createRespawnWithRetry(
   docsDir: string,
   embeddingConfig?: Partial<EmbeddingConfig>,
   idleTimeoutMs?: number,
 ): () => Promise<boolean> {
   return async () => {
-    const result = await spawnDaemon(docsDir, embeddingConfig, {
-      idleTimeoutMs,
-    });
-    return result !== null;
+    for (let attempt = 1; attempt <= RESPAWN_MAX_RETRIES; attempt++) {
+      // spawnDaemon returns null both when "already running" and "truly failed"
+      // Check isDaemonRunning after null to distinguish the two cases
+      const result = await spawnDaemon(docsDir, embeddingConfig, {
+        idleTimeoutMs,
+      });
+      if (result !== null) return true;
+      if (await isDaemonRunning()) return true;
+      if (attempt < RESPAWN_MAX_RETRIES) {
+        await new Promise((r) => setTimeout(r, RESPAWN_RETRY_DELAY_MS));
+      }
+    }
+    return false;
   };
 }
 
@@ -75,7 +87,7 @@ export async function createBackendForTier(
   daemonOptions?: { idleTimeoutMs?: number },
 ): Promise<{ backend: MemoryBackend; tier: TierInfo }> {
   const tier = await detectTier(configTier);
-  const respawn = makeRespawn(
+  const respawn = createRespawnWithRetry(
     docsDir,
     embeddingConfig,
     daemonOptions?.idleTimeoutMs,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-friend-cli",
-  "version": "1.27.2",
+  "version": "1.28.0",
   "description": "CLI for coding-friend — host learning docs, setup MCP server, initialize projects",
   "type": "module",
   "bin": {
@@ -12,8 +12,10 @@
     "prepublishOnly": "npm run build",
     "dev": "tsx src/index.ts",
     "watch": "tsup src/index.ts src/postinstall.ts --format esm --dts --watch",
-    "test": "vitest run",
-    "test:watch": "vitest"
+    "test": "vitest run && vitest run --config vitest.hooks.config.ts",
+    "test:watch": "vitest",
+    "test:hooks": "vitest run --config vitest.hooks.config.ts",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts"
   },
   "files": [
     "dist",
@@ -43,7 +45,8 @@
   "dependencies": {
     "@inquirer/prompts": "^7.0.0",
     "chalk": "^5.0.0",
-    "commander": "^13.0.0"
+    "commander": "^13.0.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/dist/chunk-2HQVNQB7.js

@@ -1,71 +0,0 @@
-import {
-  DEFAULT_CONFIG
-} from "./chunk-PRIH34UB.js";
-import {
-  globalConfigPath,
-  localConfigPath,
-  resolvePath
-} from "./chunk-TWKNGPBO.js";
-import {
-  readJson
-} from "./chunk-5UVDWG5L.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());
-  const base = deepMerge(
-    DEFAULT_CONFIG,
-    global ?? {}
-  );
-  return deepMerge(
-    base,
-    local ?? {}
-  );
-}
-function resolveDocsDir(explicitPath) {
-  if (explicitPath) {
-    return resolvePath(explicitPath);
-  }
-  const local = readJson(localConfigPath());
-  if (local?.learn?.outputDir) {
-    return resolvePath(local.learn.outputDir);
-  }
-  const global = readJson(globalConfigPath());
-  if (global?.learn?.outputDir) {
-    return resolvePath(global.learn.outputDir);
-  }
-  return resolvePath("docs/learn");
-}
-function resolveMemoryDir(explicitPath) {
-  if (explicitPath) {
-    return resolvePath(explicitPath);
-  }
-  const config = loadConfig();
-  if (config.docsDir) {
-    return resolvePath(`${config.docsDir}/memory`);
-  }
-  return resolvePath("docs/memory");
-}
-
-export {
-  loadConfig,
-  resolveDocsDir,
-  resolveMemoryDir
-};