coding-friend-cli 1.17.2 → 1.18.0

package/dist/{permission-L2QQR5PO.js → permission-Z3LOBJ4X.js}

@@ -1,11 +1,15 @@
 import {
-  PERMISSION_RULES,
+  STATIC_RULES,
   applyPermissions,
+  cleanupStalePluginRules,
+  getAllRules,
   getExistingRules,
-  groupByCategory
-} from "./chunk-56U7US6J.js";
+  groupByCategory,
+  logPluginScriptWarning
+} from "./chunk-7CAIGH2Y.js";
 import {
-  claudeLocalSettingsPath
+  claudeLocalSettingsPath,
+  claudeSettingsPath
 } from "./chunk-RWUTFVRB.js";
 import {
   log
@@ -34,6 +38,39 @@ function colorDescription(desc) {
   }
   return `${main} ${usedBy}`;
 }
+async function resolveSettingsPath(opts) {
+  if (opts.user && opts.project) {
+    log.error("Cannot use both --user and --project. Pick one.");
+    process.exit(1);
+  }
+  if (opts.user) {
+    const p2 = claudeSettingsPath();
+    return { path: p2, label: p2.replace(homedir(), "~"), scope: "user" };
+  }
+  if (opts.project) {
+    const p2 = claudeLocalSettingsPath();
+    return { path: p2, label: p2.replace(homedir(), "~"), scope: "project" };
+  }
+  if (!process.stdin.isTTY) {
+    const p2 = claudeLocalSettingsPath();
+    return { path: p2, label: p2.replace(homedir(), "~"), scope: "project" };
+  }
+  const scope = await select({
+    message: "Where should permissions be saved?",
+    choices: [
+      {
+        name: "Project \u2014 .claude/settings.local.json (this project only, gitignored)",
+        value: "project"
+      },
+      {
+        name: "User \u2014 ~/.claude/settings.json (all projects)",
+        value: "user"
+      }
+    ]
+  });
+  const p = scope === "user" ? claudeSettingsPath() : claudeLocalSettingsPath();
+  return { path: p, label: p.replace(homedir(), "~"), scope };
+}
 async function interactiveFlow(allRules, existing) {
   const groups = groupByCategory(allRules);
   const allRuleStrings = allRules.map((r) => r.rule);
@@ -98,14 +135,17 @@ async function interactiveFlow(allRules, existing) {
 async function permissionCommand(opts) {
   console.log("=== \u{1F33F} Coding Friend Permissions \u{1F33F} ===");
   console.log();
-  const settingsPath = claudeLocalSettingsPath();
-  const settingsLabel = settingsPath.replace(homedir(), "~");
+  const {
+    path: settingsPath,
+    label: settingsLabel,
+    scope
+  } = await resolveSettingsPath(opts);
   const existing = getExistingRules(settingsPath);
-  const allRules = PERMISSION_RULES;
+  const allRules = getAllRules();
   const allRuleStrings = allRules.map((r) => r.rule);
   const managedExisting = existing.filter((r) => allRuleStrings.includes(r));
   const unmanagedExisting = existing.filter((r) => !allRuleStrings.includes(r));
-  log.dim(`Settings: ${settingsLabel} (project-local)`);
+  log.dim(`Settings: ${settingsLabel} (${scope})`);
   log.dim(
     `Current: ${managedExisting.length}/${allRules.length} Coding Friend rules configured`
   );
@@ -122,13 +162,34 @@ async function permissionCommand(opts) {
       log.success("All recommended permissions already configured.");
       return;
     }
-    console.log("Adding recommended permissions:");
+    const staticSet = new Set(STATIC_RULES.map((r) => r.rule));
+    const staticCount = toAdd2.filter((r) => staticSet.has(r)).length;
+    const pluginCount = toAdd2.length - staticCount;
+    console.log(
+      `Adding ${chalk.bold(toAdd2.length)} recommended permissions${pluginCount > 0 ? ` (${staticCount} static + ${pluginCount} plugin scripts)` : ""}:`
+    );
     for (const r of toAdd2) {
       console.log(`  ${chalk.green("+")} ${r}`);
     }
+    if (pluginCount > 0) {
+      console.log();
+      logPluginScriptWarning(log, chalk);
+    }
     console.log();
+    const ok2 = !process.stdin.isTTY || await confirm({
+      message: `Apply ${toAdd2.length} permission rules to ${settingsLabel}?`,
+      default: true
+    });
+    if (!ok2) {
+      log.dim("Skipped.");
+      return;
+    }
     applyPermissions(settingsPath, toAdd2, []);
-    log.success(`Added ${toAdd2.length} permission rules.`);
+    const cleaned = cleanupStalePluginRules(settingsPath);
+    if (cleaned > 0) {
+      log.dim(`Removed ${cleaned} stale old-format plugin rules.`);
+    }
+    log.success(`Added ${toAdd2.length} permission rules to ${settingsLabel}.`);
     return;
   }
   const { toAdd, toRemove } = await interactiveFlow(allRules, existing);
@@ -160,7 +221,7 @@ async function permissionCommand(opts) {
   }
   applyPermissions(settingsPath, toAdd, toRemove);
   log.success(
-    `Done \u2014 added ${toAdd.length}, removed ${toRemove.length} rules.`
+    `Done \u2014 added ${toAdd.length}, removed ${toRemove.length} rules in ${settingsLabel}.`
   );
 }
 export {

package/dist/postinstall.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ensureShellCompletion
-} from "./chunk-YO6JKGR3.js";
+} from "./chunk-VUAUAO2R.js";
 import "./chunk-W5CD7WTX.js";
 
 // src/postinstall.ts

package/dist/{uninstall-3PSUDGI4.js → uninstall-5LRHXFSF.js}

@@ -5,7 +5,7 @@ import {
 import {
   hasShellCompletion,
   removeShellCompletion
-} from "./chunk-YO6JKGR3.js";
+} from "./chunk-VUAUAO2R.js";
 import {
   resolveScope
 } from "./chunk-C5LYVVEI.js";

package/dist/{update-WL6SFGGO.js → update-4YUSCBCB.js}

@@ -2,10 +2,10 @@ import {
   getLatestVersion,
   semverCompare,
   updateCommand
-} from "./chunk-G6CEEMAR.js";
+} from "./chunk-A427XMWE.js";
 import "./chunk-ORACWEDN.js";
 import "./chunk-POC2WHU2.js";
-import "./chunk-YO6JKGR3.js";
+import "./chunk-VUAUAO2R.js";
 import "./chunk-C5LYVVEI.js";
 import "./chunk-CYQU33FY.js";
 import "./chunk-RWUTFVRB.js";

package/lib/cf-memory/CHANGELOG.md

@@ -1,5 +1,10 @@
 # CF Memory Changelog
 
+## v0.1.3 (2026-03-19)
+
+- Use path-based project IDs instead of SHA256 hashes for human-readable project directories (e.g. `-Users-thi-git-foo` instead of `a1b2c3d4e5f6`) [#9c4cac0](https://github.com/dinhanhthi/coding-friend/commit/9c4cac0)
+- Rename `cf memory start`/`stop` to `cf memory start-daemon`/`stop-daemon` in documentation [#acbe789](https://github.com/dinhanhthi/coding-friend/commit/acbe789)
+
 ## v0.1.1 (2026-03-17)
 
 - Fix `today()` to capture full timestamp (`YYYY-MM-DD HH:MM`) instead of date-only for memory created/updated fields [#31e0824](https://github.com/dinhanhthi/coding-friend/commit/31e0824)

package/lib/cf-memory/README.md

@@ -262,8 +262,8 @@ The `cf` CLI exposes memory commands that use this package:
 | `cf memory status`         | Show current tier, daemon status, memory count                    |
 | `cf memory search <query>` | Search memories from the terminal                                 |
 | `cf memory list`           | List all stored memories                                          |
-| `cf memory start`          | Start the MiniSearch daemon (Tier 2)                              |
-| `cf memory stop`           | Stop the daemon                                                   |
+| `cf memory start-daemon`   | Start the MiniSearch daemon (Tier 2)                              |
+| `cf memory stop-daemon`    | Stop the daemon                                                   |
 | `cf memory rebuild`        | Rebuild search index (Tier 1 direct or via daemon)                |
 | `cf memory init`           | Install Tier 1 deps + import existing memories into SQLite        |
 | `cf memory mcp`            | Print MCP server config for use in Claude Desktop / other clients |

package/lib/cf-memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-friend-cf-memory",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": true,
   "type": "module",
   "bin": {

package/lib/cf-memory/src/__tests__/project-id.test.ts

@@ -0,0 +1,43 @@
+import { describe, it, expect } from "vitest";
+import { projectId } from "../backends/sqlite/index.js";
+
+describe("projectId", () => {
+  it("strips /docs/memory suffix and encodes path", () => {
+    expect(projectId("/Users/thi/git/coding-friend/docs/memory")).toBe(
+      "-Users-thi-git-coding-friend",
+    );
+  });
+
+  it("strips /memory suffix when docsDir is custom", () => {
+    expect(projectId("/Users/thi/git/foo/memory")).toBe("-Users-thi-git-foo");
+  });
+
+  it("handles path without known suffix", () => {
+    expect(projectId("/Users/thi/git/foo/custom-docs")).toBe(
+      "-Users-thi-git-foo-custom-docs",
+    );
+  });
+
+  it("strips trailing slash before encoding", () => {
+    expect(projectId("/Users/thi/git/foo/docs/memory/")).toBe(
+      projectId("/Users/thi/git/foo/docs/memory"),
+    );
+  });
+
+  it("strips multiple trailing slashes", () => {
+    expect(projectId("/Users/thi/git/foo/docs/memory///")).toBe(
+      "-Users-thi-git-foo",
+    );
+  });
+
+  it("produces same result with and without trailing slash", () => {
+    const withSlash = projectId("/a/b/c/docs/memory/");
+    const withoutSlash = projectId("/a/b/c/docs/memory");
+    expect(withSlash).toBe(withoutSlash);
+    expect(withSlash).toBe("-a-b-c");
+  });
+
+  it("handles deeply nested paths", () => {
+    expect(projectId("/a/b/c/d/e/f/g")).toBe("-a-b-c-d-e-f-g");
+  });
+});

package/lib/cf-memory/src/backends/sqlite/index.ts

@@ -7,11 +7,10 @@
  * Markdown files remain the source of truth. SQLite is a derived index
  * that can be rebuilt from markdown at any time.
  *
- * DB path: ~/.coding-friend/memory/projects/{12-char-sha256}/db.sqlite
+ * DB path: ~/.coding-friend/memory/projects/{encoded-path}/db.sqlite
  */
 import fs from "node:fs";
 import path from "node:path";
-import crypto from "node:crypto";
 import type { MemoryBackend } from "../../lib/backend.js";
 import { MarkdownBackend } from "../markdown.js";
 import {
@@ -46,14 +45,17 @@ import {
 import { hybridSearch } from "./search.js";
 
 /**
- * Compute a short hash of the docsDir path for project isolation.
+ * Derive the project root from a docsDir path by stripping known suffixes.
+ * Then encode it into a filesystem-safe directory name for project isolation.
+ * Uses the same encoding as Claude Code's project directories:
+ * resolve + strip known suffixes + strip trailing slashes + replace all "/" with "-"
+ * e.g. /Users/thi/git/foo/docs/memory → -Users-thi-git-foo
  */
-function projectHash(docsDir: string): string {
-  return crypto
-    .createHash("sha256")
-    .update(path.resolve(docsDir))
-    .digest("hex")
-    .slice(0, 12);
+export function projectId(docsDir: string): string {
+  let resolved = path.resolve(docsDir).replace(/\/+$/, "");
+  // Strip known memory directory suffixes to get the project root
+  resolved = resolved.replace(/\/docs\/memory$/, "").replace(/\/memory$/, "");
+  return resolved.replace(/\//g, "-");
 }
 
 export interface SqliteBackendOptions {
@@ -83,8 +85,8 @@ export class SqliteBackend implements MemoryBackend {
       this.dbPath = opts.dbPath;
     } else {
       const depsDir = opts?.depsDir ?? this.getDefaultDepsDir();
-      const hash = projectHash(docsDir);
-      const projectDir = path.join(depsDir, "projects", hash);
+      const id = projectId(docsDir);
+      const projectDir = path.join(depsDir, "projects", id);
       this.dbPath = path.join(projectDir, "db.sqlite");
     }
 

package/package.json

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

package/dist/chunk-56U7US6J.js

@@ -1,198 +0,0 @@
-import {
-  readJson,
-  writeJson
-} from "./chunk-RWUTFVRB.js";
-
-// src/lib/permissions.ts
-var PERMISSION_RULES = [
-  // Core (hooks & infrastructure)
-  {
-    rule: "Bash(cat:*)",
-    description: "[read-only] Read file contents (\u26A0 system-wide scope, project boundary enforced by Claude Code) \xB7 Used by: session-init hook",
-    category: "Core",
-    recommended: true
-  },
-  {
-    rule: "Bash(grep:*)",
-    description: "[read-only] Search file contents (\u26A0 system-wide scope, project boundary enforced by Claude Code) \xB7 Used by: session-init hook, skills",
-    category: "Core",
-    recommended: true
-  },
-  {
-    rule: "Bash(sed:*)",
-    description: "[modify] Text transformation \xB7 Used by: session-init hook",
-    category: "Core",
-    recommended: true
-  },
-  {
-    rule: "Bash(tr:*)",
-    description: "[read-only] Character translation \xB7 Used by: session-init hook",
-    category: "Core",
-    recommended: true
-  },
-  {
-    rule: "Bash(wc:*)",
-    description: "[read-only] Count lines/words \xB7 Used by: cf-verification, skills",
-    category: "Core",
-    recommended: true
-  },
-  {
-    rule: "Bash(mkdir:*)",
-    description: "[write] Create directories \xB7 Used by: docs folder setup",
-    category: "Core",
-    recommended: true
-  },
-  // Git Operations
-  {
-    rule: "Bash(git add:*)",
-    description: "[modify] Stage files for commit \xB7 Used by: /cf-commit, /cf-ship",
-    category: "Git",
-    recommended: true
-  },
-  {
-    rule: "Bash(git commit:*)",
-    description: "[modify] Create commits \xB7 Used by: /cf-commit, /cf-ship",
-    category: "Git",
-    recommended: true
-  },
-  {
-    rule: "Bash(git status:*)",
-    description: "[read-only] Check working tree status \xB7 Used by: /cf-commit, /cf-review, cf-verification",
-    category: "Git",
-    recommended: true
-  },
-  {
-    rule: "Bash(git diff:*)",
-    description: "[read-only] View file changes \xB7 Used by: /cf-commit, /cf-review, cf-verification",
-    category: "Git",
-    recommended: true
-  },
-  {
-    rule: "Bash(git log:*)",
-    description: "[read-only] View commit history \xB7 Used by: /cf-commit, /cf-review, cf-sys-debug",
-    category: "Git",
-    recommended: true
-  },
-  {
-    rule: "Bash(git push:*)",
-    description: "[remote] Push commits to remote \xB7 Used by: /cf-ship",
-    category: "Git",
-    recommended: true
-  },
-  {
-    rule: "Bash(git pull:*)",
-    description: "[remote] Pull changes from remote \xB7 Used by: /cf-ship",
-    category: "Git",
-    recommended: true
-  },
-  {
-    rule: "Bash(gh pr create:*)",
-    description: "[remote] Create GitHub pull requests \xB7 Used by: /cf-ship",
-    category: "Git",
-    recommended: true
-  },
-  // Testing & Build
-  {
-    rule: "Bash(npm test:*)",
-    description: "[execute] Run test suites \xB7 Used by: cf-verification, /cf-fix, cf-tdd",
-    category: "Testing & Build",
-    recommended: true
-  },
-  {
-    rule: "Bash(npm run:*)",
-    description: "[execute] Run npm scripts (build, lint, format) \xB7 Used by: cf-verification",
-    category: "Testing & Build",
-    recommended: true
-  },
-  // Web & Research
-  {
-    rule: "WebSearch",
-    description: "[network] Perform web searches \xB7 Used by: /cf-research",
-    category: "Web & Research",
-    recommended: false
-  },
-  {
-    rule: "WebFetch(domain:*)",
-    description: "[network] Fetch content from web pages \xB7 Used by: /cf-research",
-    category: "Web & Research",
-    recommended: false
-  }
-];
-function getExistingRules(settingsPath) {
-  const settings = readJson(settingsPath);
-  if (!settings) return [];
-  const permissions = settings.permissions;
-  return permissions?.allow ?? [];
-}
-function getMissingRules(existing, rules) {
-  return rules.filter((r) => !existing.includes(r.rule));
-}
-function buildLearnDirRules(learnPath, autoCommit) {
-  const rules = [
-    {
-      rule: `Read(${learnPath}/**)`,
-      description: "[read-only] Read learning docs \xB7 Used by: /cf-learn",
-      category: "External Learn Directory",
-      recommended: true
-    },
-    {
-      rule: `Edit(${learnPath}/**)`,
-      description: "[modify] Edit learning docs \xB7 Used by: /cf-learn",
-      category: "External Learn Directory",
-      recommended: true
-    },
-    {
-      rule: `Write(${learnPath}/**)`,
-      description: "[write] Write learning docs \xB7 Used by: /cf-learn",
-      category: "External Learn Directory",
-      recommended: true
-    }
-  ];
-  if (autoCommit) {
-    const quoted = learnPath.includes(" ") ? `"${learnPath}"` : learnPath;
-    rules.push({
-      rule: `Bash(cd ${quoted} && git add:*)`,
-      description: "[modify] Stage learning docs for commit \xB7 Used by: /cf-learn auto-commit",
-      category: "External Learn Directory",
-      recommended: true
-    });
-    rules.push({
-      rule: `Bash(cd ${quoted} && git commit:*)`,
-      description: "[modify] Commit learning docs \xB7 Used by: /cf-learn auto-commit",
-      category: "External Learn Directory",
-      recommended: true
-    });
-  }
-  return rules;
-}
-function applyPermissions(settingsPath, toAdd, toRemove) {
-  const settings = readJson(settingsPath) ?? {};
-  const permissions = settings.permissions ?? {};
-  const existing = permissions.allow ?? [];
-  const afterRemove = existing.filter((r) => !toRemove.includes(r));
-  const afterAdd = [
-    ...afterRemove,
-    ...toAdd.filter((r) => !afterRemove.includes(r))
-  ];
-  permissions.allow = afterAdd;
-  settings.permissions = permissions;
-  writeJson(settingsPath, settings);
-}
-function groupByCategory(rules) {
-  const groups = /* @__PURE__ */ new Map();
-  for (const rule of rules) {
-    const list = groups.get(rule.category) ?? [];
-    list.push(rule);
-    groups.set(rule.category, list);
-  }
-  return groups;
-}
-
-export {
-  PERMISSION_RULES,
-  getExistingRules,
-  getMissingRules,
-  buildLearnDirRules,
-  applyPermissions,
-  groupByCategory
-};