coding-friend-cli 1.34.1 → 1.35.0

package/dist/{host-6IBKKCPA.js → host-HKA4OHBM.js}

@@ -1,15 +1,15 @@
 import {
   resolveDocsDir
-} from "./chunk-AZ6AK5M4.js";
+} from "./chunk-B2NFXRFP.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
-import "./chunk-DHH6SRXV.js";
-import "./chunk-TWKNGPBO.js";
+import "./chunk-57EGAXYI.js";
 import {
   run,
   streamExec
 } from "./chunk-EVGXUDX4.js";
+import "./chunk-TWKNGPBO.js";
 import {
   log,
   printBanner

package/dist/index.js

@@ -14,64 +14,68 @@ 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-22BLHQ6D.js");
+  const { installCommand } = await import("./install-VYZSTXN6.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-6ZJRS2H4.js");
+  const { uninstallCommand } = await import("./uninstall-QKEC3O64.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-ZWQVU3QZ.js");
+  const { disableCommand } = await import("./disable-CDOM7SSI.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-NXP6APNI.js");
+  const { enableCommand } = await import("./enable-SF7742UR.js");
   await enableCommand(opts);
 });
 program.command("init").description("Initialize coding-friend in current project").action(async () => {
-  const { initCommand } = await import("./init-KY3ZPEWP.js");
+  const { initCommand } = await import("./init-YM7YEEGK.js");
   await initCommand();
 });
 program.command("config").description("Manage Coding Friend configuration").action(async () => {
-  const { configCommand } = await import("./config-44VQBNMS.js");
+  const { configCommand } = await import("./config-HTQAALMA.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-6IBKKCPA.js");
+  const { hostCommand } = await import("./host-HKA4OHBM.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-OGZAZZRF.js");
-  await mcpCommand(path);
+program.command("mcp").description("Setup MCP server for learning docs").action(async () => {
+  const { mcpCommand } = await import("./mcp-7MO2MCLE.js");
+  await mcpCommand();
 });
 program.command("mcp-serve").description("Start the cf-memory MCP server (used internally by npx)").argument("<memoryDir>", "path to memory directory").action(async (memoryDir) => {
   const { mcpServeCommand } = await import("./mcp-serve-3FEPFVVQ.js");
   await mcpServeCommand(memoryDir);
 });
 program.command("mcp-serve-learn").description("Start the learn MCP server (used internally by npx)").argument("<docsDir>", "path to docs directory").action(async (docsDir) => {
-  const { mcpServeLearnCommand } = await import("./mcp-serve-learn-UNW6VH5M.js");
+  const { mcpServeLearnCommand } = await import("./mcp-serve-learn-OKVC5WV3.js");
   await mcpServeLearnCommand(docsDir);
 });
 program.command("permission").description("Manage Claude Code permission rules for Coding Friend").option("--all", "Apply all recommended permissions without prompts").option("--user", "Save to user-level settings (~/.claude/settings.json)").option(
   "--project",
   "Save to project-level settings (.claude/settings.local.json)"
 ).action(async (opts) => {
-  const { permissionCommand } = await import("./permission-DNW7DE24.js");
+  const { permissionCommand } = await import("./permission-C5R3LMZQ.js");
   await permissionCommand(opts);
 });
 program.command("statusline").description("Setup coding-friend statusline in Claude Code").action(async () => {
-  const { statuslineCommand } = await import("./statusline-GKVAX7GR.js");
+  const { statuslineCommand } = await import("./statusline-VFIA7OS2.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-P5ZR2JVQ.js");
+  const { updateCommand } = await import("./update-IV4Y3T72.js");
   await updateCommand(opts);
 });
 program.command("status").description("Show comprehensive Coding Friend status").action(async () => {
-  const { statusCommand } = await import("./status-NMSVOSC4.js");
+  const { statusCommand } = await import("./status-2XM5OZDR.js");
   await statusCommand();
 });
+program.command("clean").description("Clean files generated by Coding Friend in docs/").action(async () => {
+  const { cleanCommand } = await import("./clean-67ACB4OS.js");
+  await cleanCommand();
+});
 var session = program.command("session").description("Save and load Claude Code sessions across machines");
 program.addHelpText(
   "after",
@@ -84,11 +88,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-RCEE6P35.js");
+  const { sessionSaveCommand } = await import("./session-M4KRQ4VU.js");
   await sessionSaveCommand(opts);
 });
 session.command("load").description("Load a saved session from sync folder").action(async () => {
-  const { sessionLoadCommand } = await import("./session-RCEE6P35.js");
+  const { sessionLoadCommand } = await import("./session-M4KRQ4VU.js");
   await sessionLoadCommand();
 });
 var memory = program.command("memory").description("AI memory system \u2014 store and search project knowledge");
@@ -108,43 +112,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-JM45DEIX.js");
+  const { memoryStatusCommand } = await import("./memory-XALEMWQF.js");
   await memoryStatusCommand();
 });
 memory.command("search").description("Search memories by query").argument("<query>", "search query").action(async (query) => {
-  const { memorySearchCommand } = await import("./memory-JM45DEIX.js");
+  const { memorySearchCommand } = await import("./memory-XALEMWQF.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-JM45DEIX.js");
+  const { memoryListCommand } = await import("./memory-XALEMWQF.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-JM45DEIX.js");
+  const { memoryInitCommand } = await import("./memory-XALEMWQF.js");
   await memoryInitCommand();
 });
 memory.command("config").description("Configure memory system settings").action(async () => {
-  const { memoryConfigCommand } = await import("./memory-JM45DEIX.js");
+  const { memoryConfigCommand } = await import("./memory-XALEMWQF.js");
   await memoryConfigCommand();
 });
 memory.command("start-daemon").description("Start the memory daemon (Tier 2 \u2014 MiniSearch)").action(async () => {
-  const { memoryStartDaemonCommand } = await import("./memory-JM45DEIX.js");
+  const { memoryStartDaemonCommand } = await import("./memory-XALEMWQF.js");
   await memoryStartDaemonCommand();
 });
 memory.command("stop-daemon").description("Stop the memory daemon").action(async () => {
-  const { memoryStopDaemonCommand } = await import("./memory-JM45DEIX.js");
+  const { memoryStopDaemonCommand } = await import("./memory-XALEMWQF.js");
   await memoryStopDaemonCommand();
 });
 memory.command("rebuild").description("Rebuild the daemon search index").action(async () => {
-  const { memoryRebuildCommand } = await import("./memory-JM45DEIX.js");
+  const { memoryRebuildCommand } = await import("./memory-XALEMWQF.js");
   await memoryRebuildCommand();
 });
 memory.command("mcp").description("Show MCP server setup instructions").action(async () => {
-  const { memoryMcpCommand } = await import("./memory-JM45DEIX.js");
+  const { memoryMcpCommand } = await import("./memory-XALEMWQF.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(
@@ -152,7 +156,7 @@ memory.command("rm").description("Remove a project database").option("--project-
   "Remove orphaned projects (source dir missing or 0 memories)"
 ).action(
   async (opts) => {
-    const { memoryRmCommand } = await import("./memory-JM45DEIX.js");
+    const { memoryRmCommand } = await import("./memory-XALEMWQF.js");
     await memoryRmCommand(opts);
   }
 );
@@ -178,41 +182,41 @@ Dev subcommands:
   dev update [path]   Update local dev plugin to latest version`
 );
 dev.command("on").description("Switch to local plugin source").argument("[path]", "path to local coding-friend repo (default: cwd)").action(async (path) => {
-  const { devOnCommand } = await import("./dev-QXVERU42.js");
+  const { devOnCommand } = await import("./dev-PFUF67SH.js");
   await devOnCommand(path);
 });
 dev.command("off").description("Switch back to remote marketplace").action(async () => {
-  const { devOffCommand } = await import("./dev-QXVERU42.js");
+  const { devOffCommand } = await import("./dev-PFUF67SH.js");
   await devOffCommand();
 });
 dev.command("status").description("Show current dev mode").action(async () => {
-  const { devStatusCommand } = await import("./dev-QXVERU42.js");
+  const { devStatusCommand } = await import("./dev-PFUF67SH.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-QXVERU42.js");
+  const { devSyncCommand } = await import("./dev-PFUF67SH.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-QXVERU42.js");
+  const { devRestartCommand } = await import("./dev-PFUF67SH.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-QXVERU42.js");
+  const { devUpdateCommand } = await import("./dev-PFUF67SH.js");
   await devUpdateCommand(path);
 });
 program.hook("postAction", async () => {
   const topCmd = process.argv[2];
   if (topCmd === "update") return;
-  const { checkAndNotifyCliUpdate } = await import("./update-check-5SCD2JR2.js");
+  const { checkAndNotifyCliUpdate } = await import("./update-check-BPCQ25AR.js");
   checkAndNotifyCliUpdate(pkg.version);
 });
 await program.parseAsync();

package/dist/{init-KY3ZPEWP.js → init-YM7YEEGK.js}

@@ -2,12 +2,16 @@ import {
   ensureMemoryBuilt,
   isMemoryInitialized,
   memoryInitWizard
-} from "./chunk-FAANBGCB.js";
-import "./chunk-FI5HEQ43.js";
+} from "./chunk-L53RNEV3.js";
+import "./chunk-E5J24GD5.js";
+import {
+  isLearnMcpRegistered,
+  registerLearnMcp
+} from "./chunk-WSUYLIYX.js";
 import {
   memoryConfigMenu
-} from "./chunk-QCKIBJF6.js";
-import "./chunk-AZ6AK5M4.js";
+} from "./chunk-C5YWESSF.js";
+import "./chunk-B2NFXRFP.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
@@ -21,14 +25,14 @@ import {
   saveStatuslineConfig,
   selectStatuslineComponents,
   writeStatuslineSettings
-} from "./chunk-LXZ47XCD.js";
+} from "./chunk-WNTMKIKC.js";
 import {
   DEFAULT_CONFIG
-} from "./chunk-DHH6SRXV.js";
+} from "./chunk-57EGAXYI.js";
 import {
   ensureShellCompletion,
   hasShellCompletion
-} from "./chunk-DMJCO6LJ.js";
+} from "./chunk-RLUNNJWJ.js";
 import {
   BACK,
   applyDocsDirChange,
@@ -39,7 +43,11 @@ import {
   getScopeLabel,
   injectBackChoice,
   showConfigHint
-} from "./chunk-Z5Q533UG.js";
+} from "./chunk-HPNRQYLM.js";
+import {
+  commandExists,
+  run
+} from "./chunk-EVGXUDX4.js";
 import {
   claudeLocalSettingsPath,
   claudeProjectSettingsPath,
@@ -48,10 +56,6 @@ import {
   localConfigPath,
   resolvePath
 } from "./chunk-TWKNGPBO.js";
-import {
-  commandExists,
-  run
-} from "./chunk-EVGXUDX4.js";
 import {
   log,
   printBanner
@@ -73,7 +77,7 @@ import {
 
 // src/commands/init.ts
 import { checkbox, confirm, input, select } from "@inquirer/prompts";
-import { existsSync, readFileSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
 import chalk from "chalk";
@@ -115,14 +119,7 @@ function paddedScopeLabel(scope) {
 }
 function printSetupStatus(globalCfg, localCfg, gitAvailable) {
   const docsDir = getDocsDir(globalCfg, localCfg);
-  const subfolders = [
-    "plans",
-    "memory",
-    "research",
-    "learn",
-    "sessions",
-    "reviews"
-  ];
+  const subfolders = ["plans", "memory", "research", "sessions", "reviews"];
   const folderStatus = subfolders.map((sub) => ({
     name: `${docsDir}/${sub}`,
     exists: existsSync(`${docsDir}/${sub}`)
@@ -246,7 +243,6 @@ async function stepDocsDir(globalCfg, localCfg) {
       "plans",
       "memory",
       "research",
-      "learn",
       "sessions",
       "reviews"
     ];
@@ -272,7 +268,6 @@ async function stepDocsDir(globalCfg, localCfg) {
     "plans",
     "memory",
     "research",
-    "learn",
     "sessions",
     "reviews"
   ];
@@ -313,7 +308,6 @@ async function stepGitignore(docsDir) {
     `${docsDir}/plans/`,
     `${docsDir}/memory/`,
     `${docsDir}/research/`,
-    `${docsDir}/learn/`,
     `${docsDir}/sessions/`,
     `${docsDir}/reviews/`,
     `${docsDir}/context/`,
@@ -389,56 +383,43 @@ async function selectLanguage(message) {
   }
   return choice;
 }
-async function stepLearnConfig(globalCfg, localCfg, gitAvailable) {
-  const currentLearn = localCfg?.learn ?? globalCfg?.learn;
-  const scopeLabel = getScopeLabel("learn", globalCfg, localCfg);
-  const docsDir = getDocsDir(globalCfg, localCfg);
+async function stepLearnConfig(globalCfg) {
+  const globalLearn = globalCfg?.learn;
+  const defaultLearnDir = DEFAULT_CONFIG.learn.outputDir;
+  const currentOutputDir = globalLearn?.outputDir ?? defaultLearnDir;
   printStepHeader(
-    `/cf-learn config ${formatScopeLabel(scopeLabel)}`,
+    "/cf-learn config",
     "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?"
   );
   const locationChoice = await select({
-    message: "Where to store learning docs?",
+    message: `Current learn folder: ${currentOutputDir}`,
     choices: injectBackChoice(
       [
-        { name: `In this project (${docsDir}/learn/)`, value: "local" },
-        { name: "A separate folder", value: "external" }
+        {
+          name: `Use default (${defaultLearnDir})`,
+          value: "default"
+        },
+        { name: "Custom path\u2026", value: "custom" }
       ],
       "Cancel init"
     )
   });
   handleBack(locationChoice);
-  let outputDir = `${docsDir}/learn`;
-  let isExternal = false;
-  if (locationChoice === "external") {
+  let outputDir = defaultLearnDir;
+  if (locationChoice === "custom") {
     outputDir = await input({
       message: "Enter path (absolute or ~/...):",
-      default: currentLearn?.outputDir ?? void 0,
-      validate: (val) => val.length > 0 ? true : "Path cannot be empty"
+      default: currentOutputDir !== defaultLearnDir ? currentOutputDir : void 0,
+      validate: (val) => {
+        if (val.length === 0) return "Path cannot be empty";
+        if (!val.startsWith("/") && !val.startsWith("~/"))
+          return "Path must be absolute (e.g. /home/user/learn) or start with ~/ (e.g. ~/learn)";
+        return true;
+      }
     });
-    isExternal = true;
     const resolved = resolvePath(outputDir);
     if (!existsSync(resolved)) {
       const create = await confirm({
@@ -446,12 +427,12 @@ async function stepLearnConfig(globalCfg, localCfg, gitAvailable) {
         default: true
       });
       if (create) {
-        run("mkdir", ["-p", resolved]);
+        mkdirSync(resolved, { recursive: true });
         log.success(`Created ${resolved}`);
       }
     }
   }
-  const existingCats = currentLearn?.categories;
+  const existingCats = globalLearn?.categories;
   const defaultNames = DEFAULT_CONFIG.learn.categories.map((c) => c.name).join(", ");
   const catChoices = [
     { name: `Use defaults (${defaultNames})`, value: "defaults" }
@@ -507,10 +488,18 @@ async function stepLearnConfig(globalCfg, localCfg, gitAvailable) {
     if (customCats.length > 0) categories = customCats;
   }
   let autoCommit = false;
-  if (isExternal && gitAvailable) {
+  const resolvedOutputDir = resolvePath(outputDir);
+  const gitInLearnDir = run("git", [
+    "-C",
+    resolvedOutputDir,
+    "rev-parse",
+    "--is-inside-work-tree"
+  ]);
+  const learnDirIsGit = gitInLearnDir !== null;
+  if (learnDirIsGit) {
     autoCommit = await confirm({
       message: "Auto-commit learning docs to git after each /cf-learn?",
-      default: currentLearn?.autoCommit ?? false
+      default: globalLearn?.autoCommit ?? false
     });
   }
   const indexChoice = await select({
@@ -535,17 +524,11 @@ async function stepLearnConfig(globalCfg, localCfg, gitAvailable) {
     autoCommit,
     readmeIndex
   };
-  const scope = await askScope();
-  if (scope === "back") {
-    log.dim("Skipped /cf-learn config.");
-    return { outputDir, autoCommit, isExternal };
-  }
-  const targetPath = scope === "global" ? globalConfigPath() : localConfigPath();
-  const existingConfig = readJson(targetPath);
+  const existingConfig = readJson(globalConfigPath());
   const existingLearn = existingConfig?.learn ?? {};
-  mergeJson(targetPath, { learn: { ...existingLearn, ...learnObj } });
-  log.success(`Saved to ${targetPath}`);
-  return { outputDir, autoCommit, isExternal };
+  mergeJson(globalConfigPath(), { learn: { ...existingLearn, ...learnObj } });
+  log.success(`Saved to ${globalConfigPath()}`);
+  return { outputDir, autoCommit };
 }
 async function stepShellCompletion() {
   if (hasShellCompletion()) {
@@ -657,6 +640,62 @@ async function stepMemory(docsDir, opts) {
   const memoryDir = join(process.cwd(), docsDir, "memory");
   await memoryInitWizard(memoryDir, mcpDir);
 }
+async function stepTdd(globalCfg, localCfg) {
+  const currentValue = getMergedValue("tdd", globalCfg, localCfg);
+  const scopeLabel = getScopeLabel("tdd", globalCfg, localCfg);
+  printStepHeader(
+    `TDD ${formatScopeLabel(scopeLabel)}${currentValue !== void 0 ? ` (${currentValue})` : ""}`,
+    "Enable TDD (RED\u2192GREEN\u2192REFACTOR) by default for all implementations."
+  );
+  const tddChoice = await confirm({
+    message: "Enable TDD by default? (writes failing tests before code \u2014 RED \u2192 GREEN \u2192 REFACTOR)",
+    default: currentValue ?? false
+  });
+  const scope = await askScope();
+  if (scope === "back") {
+    log.dim("Skipped TDD config.");
+    return;
+  }
+  const targetPath = scope === "global" ? globalConfigPath() : localConfigPath();
+  mergeJson(targetPath, { tdd: tddChoice });
+  log.success(`Saved to ${targetPath}`);
+}
+async function stepAutoApprove(globalCfg, localCfg) {
+  const currentValue = getMergedValue("autoApprove", globalCfg, localCfg);
+  const scopeLabel = getScopeLabel("autoApprove", globalCfg, localCfg);
+  printStepHeader(
+    `Auto-approve ${formatScopeLabel(scopeLabel)}${currentValue !== void 0 ? ` (${currentValue})` : ""}`,
+    "Auto-approves safe tool calls, blocks destructive ones, prompts for ambiguous."
+  );
+  const autoApproveChoice = await confirm({
+    message: "Enable auto-approve? (auto-approves read-only tools + working-dir file edits, LLM classifier for unknowns)",
+    default: currentValue ?? false
+  });
+  const scope = await askScope();
+  if (scope === "back") {
+    log.dim("Skipped auto-approve config.");
+    return;
+  }
+  const targetPath = scope === "global" ? globalConfigPath() : localConfigPath();
+  mergeJson(targetPath, { autoApprove: autoApproveChoice });
+  log.success(`Saved to ${targetPath}`);
+  if (autoApproveChoice) {
+    const { runDangerousRulesAudit } = await import("./permissions-LYADLYYK.js");
+    await runDangerousRulesAudit(
+      [
+        claudeProjectSettingsPath(),
+        claudeLocalSettingsPath(),
+        claudeSettingsPath()
+      ],
+      log,
+      (message) => confirm({ message, default: true })
+    );
+    log.dim(
+      "Tip: Fine-tune with autoApproveAllowExtra / autoApproveIgnore in config.json"
+    );
+    log.dim("Docs: https://cf.dinhanhthi.com/docs/reference/auto-approve/");
+  }
+}
 async function stepClaudePermissions(externalLearnDir, autoCommit) {
   const scope = await select({
     message: "Where should permissions be saved?",
@@ -736,6 +775,8 @@ async function initMenu(gitAvailable) {
     const completionStatus = hasShellCompletion() ? chalk.green("installed") : chalk.yellow("not installed");
     const statuslineStatus = isStatuslineConfigured() ? chalk.green("configured") : chalk.yellow("not configured");
     const memoryStatus = isMemoryInitialized() ? chalk.green("initialized") : chalk.yellow("not configured");
+    const tddScope = getScopeLabel("tdd", globalCfg, localCfg);
+    const tddVal = getMergedValue("tdd", globalCfg, localCfg);
     const autoApproveScope = getScopeLabel("autoApprove", globalCfg, localCfg);
     const autoApproveVal = getMergedValue(
       "autoApprove",
@@ -788,6 +829,11 @@ async function initMenu(gitAvailable) {
         value: "memory",
         description: "  Persistent project knowledge \u2014 search tier, embeddings, MCP"
       },
+      {
+        name: `TDD ${formatScopeLabel(tddScope)}${tddVal !== void 0 ? ` (${tddVal})` : ""}`,
+        value: "tdd",
+        description: "  Enable TDD (RED\u2192GREEN\u2192REFACTOR) by default for all implementations"
+      },
       {
         name: `Auto-approve ${formatScopeLabel(autoApproveScope)}${autoApproveVal !== void 0 ? ` (${autoApproveVal})` : ""}`,
         value: "autoApprove",
@@ -819,7 +865,7 @@ async function initMenu(gitAvailable) {
         await stepDocsLanguage(globalCfg, localCfg);
         break;
       case "learn":
-        await stepLearnConfig(globalCfg, localCfg, gitAvailable);
+        await stepLearnConfig(globalCfg);
         break;
       case "completion":
         await stepShellCompletion();
@@ -830,6 +876,19 @@ async function initMenu(gitAvailable) {
       case "memory":
         await stepMemory(docsDir, { menuMode: true });
         break;
+      case "tdd": {
+        const tddChoice = await confirm({
+          message: "Enable TDD by default? (writes failing tests before code \u2014 RED \u2192 GREEN \u2192 REFACTOR)",
+          default: tddVal ?? false
+        });
+        const tddTargetScope = await askScope();
+        if (tddTargetScope !== "back") {
+          const targetPath = tddTargetScope === "global" ? globalConfigPath() : localConfigPath();
+          mergeJson(targetPath, { tdd: tddChoice });
+          log.success(`Saved to ${targetPath}`);
+        }
+        break;
+      }
       case "autoApprove": {
         const autoApproveChoice = await confirm({
           message: "Enable auto-approve? (auto-approves read-only tools + working-dir file edits, LLM classifier for unknowns)",
@@ -862,14 +921,10 @@ async function initMenu(gitAvailable) {
         break;
       }
       case "permissions": {
-        const learnCfg = localCfg?.learn ?? globalCfg?.learn;
-        const learnOutputDir = learnCfg?.outputDir || `${docsDir}/learn`;
-        const learnIsExternal = !learnOutputDir.startsWith(`${docsDir}/`);
+        const learnCfg = globalCfg?.learn;
+        const learnOutputDir = learnCfg?.outputDir ?? DEFAULT_CONFIG.learn.outputDir;
         const learnAutoCommit = learnCfg?.autoCommit || false;
-        await stepClaudePermissions(
-          learnIsExternal ? learnOutputDir : null,
-          learnAutoCommit
-        );
+        await stepClaudePermissions(learnOutputDir, learnAutoCommit);
         break;
       }
     }
@@ -982,19 +1037,32 @@ async function initCommand() {
     log.dim("Skipped \u2014 not inside a git repo.");
   }
   await stepDocsLanguage(globalCfg, localCfg);
-  const { outputDir, autoCommit, isExternal } = await stepLearnConfig(
-    updatedGlobal,
-    updatedLocal,
-    gitAvailable
-  );
+  const { outputDir, autoCommit } = await stepLearnConfig(updatedGlobal);
+  if (isLearnMcpRegistered()) {
+    log.dim("coding-friend-learn: already registered");
+    log.dim(
+      "  (If it points to an old path, run: claude mcp remove --scope user coding-friend-learn && cf mcp)"
+    );
+  } else {
+    const registered = registerLearnMcp(outputDir);
+    if (registered) {
+      log.success(
+        "Registered CF Learn MCP (user scope). Restart Claude Code to activate."
+      );
+    }
+  }
   await stepShellCompletion();
   await stepStatusline();
   await stepMemory(docsDir);
+  const finalGlobal = readJson(globalConfigPath());
+  const finalLocal = readJson(localConfigPath());
+  await stepTdd(finalGlobal, finalLocal);
+  await stepAutoApprove(finalGlobal, finalLocal);
   printStepHeader(
     "Configure Claude permissions",
     "Grants Coding Friend skills/hooks the permissions they need, so you get fewer prompts."
   );
-  await stepClaudePermissions(isExternal ? outputDir : null, autoCommit);
+  await stepClaudePermissions(outputDir, autoCommit);
   if (!existsSync(localConfigPath())) {
     writeJson(localConfigPath(), {});
   }