coding-friend-cli 1.27.1 → 1.27.2

package/dist/index.js

@@ -30,7 +30,7 @@ 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-KX6Y3ELD.js");
+  const { initCommand } = await import("./init-FM5D5CD2.js");
   await initCommand();
 });
 program.command("config").description("Manage Coding Friend configuration").action(async () => {
@@ -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-DMQZXZ7F.js");
+  const { sessionSaveCommand } = await import("./session-VXYTI2C6.js");
   await sessionSaveCommand(opts);
 });
 session.command("load").description("Load a saved session from sync folder").action(async () => {
-  const { sessionLoadCommand } = await import("./session-DMQZXZ7F.js");
+  const { sessionLoadCommand } = await import("./session-VXYTI2C6.js");
   await sessionLoadCommand();
 });
 var memory = program.command("memory").description("AI memory system \u2014 store and search project knowledge");

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

@@ -980,7 +980,7 @@ async function initCommand() {
   console.log();
   log.congrats("Setup complete!");
   log.dim(
-    "Available commands: /cf-ask, /cf-plan, /cf-fix, /cf-commit, /cf-review, /cf-review-out, /cf-review-in, /cf-ship, /cf-optimize, /cf-scan, /cf-remember, /cf-learn, /cf-research, /cf-session, /cf-help"
+    "Available commands: /cf-ask, /cf-plan, /cf-fix, /cf-commit, /cf-review, /cf-review-out, /cf-review-in, /cf-ship, /cf-optimize, /cf-scan, /cf-remember, /cf-learn, /cf-teach, /cf-research, /cf-session, /cf-warm, /cf-help"
   );
 }
 export {

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

@@ -32,6 +32,10 @@ import {
 } from "fs";
 import { join } from "path";
 import { hostname as osHostname } from "os";
+function slugifyLabel(label, maxLen = 100) {
+  const slug = label.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, maxLen).replace(/-+$/, "");
+  return slug || "session";
+}
 function buildPreviewText(jsonlPath, maxChars = 200) {
   try {
     const content = readFileSync(jsonlPath, "utf-8");
@@ -65,7 +69,10 @@ function listSyncedSessions(syncDir) {
   for (const entry of entries) {
     const metaPath = join(sessionsDir, entry, "meta.json");
     const meta = readJson(metaPath);
-    if (meta) metas.push(meta);
+    if (meta) {
+      if (!meta.folderName) meta.folderName = entry;
+      metas.push(meta);
+    }
   }
   return metas.sort(
     (a, b) => new Date(b.savedAt).getTime() - new Date(a.savedAt).getTime()
@@ -92,13 +99,17 @@ function remapProjectPath(originalPath, currentHome) {
 }
 function saveSession(opts) {
   const { jsonlPath, sessionId, label, projectPath, syncDir, previewText } = opts;
-  const destDir = join(syncDir, "sessions", sessionId);
+  const sessionsDir = join(syncDir, "sessions");
+  const baseSlug = slugifyLabel(label);
+  const folderName = uniqueFolderName(sessionsDir, baseSlug);
+  const destDir = join(sessionsDir, folderName);
   const destJsonl = join(destDir, "session.jsonl");
   const destMeta = join(destDir, "meta.json");
   mkdirSync(destDir, { recursive: true });
   copyFileSync(jsonlPath, destJsonl);
   const meta = {
     sessionId,
+    folderName,
     label,
     projectPath,
     savedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -106,12 +117,20 @@ function saveSession(opts) {
     previewText
   };
   writeJson(destMeta, meta);
+  return folderName;
+}
+function uniqueFolderName(sessionsDir, base) {
+  if (!existsSync(join(sessionsDir, base))) return base;
+  let i = 2;
+  while (existsSync(join(sessionsDir, `${base}-${i}`))) i++;
+  return `${base}-${i}`;
 }
 function loadSession(meta, localProjectPath, syncDir) {
   const encodedPath = encodeProjectPath(localProjectPath);
   const destDir = claudeSessionDir(encodedPath);
   const destPath = join(destDir, `${meta.sessionId}.jsonl`);
-  const srcPath = join(syncDir, "sessions", meta.sessionId, "session.jsonl");
+  const folder = meta.folderName ?? meta.sessionId;
+  const srcPath = join(syncDir, "sessions", folder, "session.jsonl");
   mkdirSync(destDir, { recursive: true });
   copyFileSync(srcPath, destPath);
 }
@@ -184,7 +203,7 @@ async function sessionSaveCommand(opts = {}) {
     default: `session-${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`
   });
   const previewText = buildPreviewText(jsonlPath);
-  saveSession({
+  const folderName = saveSession({
     jsonlPath,
     sessionId,
     label,
@@ -193,7 +212,7 @@ async function sessionSaveCommand(opts = {}) {
     previewText
   });
   log.success(`Session saved: "${label}"`);
-  log.dim(`  \u2192 ${join2(docsDir, "sessions", sessionId)}`);
+  log.dim(`  \u2192 ${join2(docsDir, "sessions", folderName)}`);
 }
 async function sessionLoadCommand() {
   const docsDir = resolveDocsDir();

package/lib/cf-memory/README.md

@@ -48,7 +48,7 @@ Detection: Tier 1 → Tier 2 → Tier 3 (first available wins).
 
 Memories are stored as Markdown files with YAML frontmatter in `docs/memory/<category>/`.
 
-Convention memories (`preference` type → `conventions/` folder) are also synced to the project's `CLAUDE.md` under a `## CF Memory: Conventions` section. Entries are tracked via HTML comments (`<!-- cf:<id> -->`) and are automatically added, updated, or removed when the corresponding memory is stored, updated, or deleted.
+Convention memories (`preference` type → `conventions/` folder) are automatically synced to the project's `CLAUDE.md` under a `## CF Memory: Project Rules` section. Other memory types can opt-in to CLAUDE.md sync by setting `sync_to_claude_md: true` when storing or updating — useful for decisions, infrastructure rules, or any project-wide rules that future sessions must follow. Entries are tracked via HTML comments (`<!-- cf:<id> -->`) and are automatically added, updated, or removed when the corresponding memory is stored, updated, or deleted.
 
 ## Embedding Models
 

package/lib/cf-memory/src/__tests__/claude-md.test.ts

@@ -236,3 +236,108 @@ describe("syncToClaudeMd with realistic docsDir", () => {
     expect(content).toContain(SECTION_HEADER);
   });
 });
+
+describe("migration from old header", () => {
+  const OLD_HEADER = "## CF Memory: Conventions";
+
+  it("reads entries from old header and rewrites with new header on sync", () => {
+    writeFileSync(
+      claudeMdFile,
+      `# My Project\n\n${OLD_HEADER}\n\n- Old rule <!-- cf:conventions/old-rule -->\n`,
+    );
+
+    syncToClaudeMd(testDir, "conventions/new-rule", "New rule");
+
+    const content = readFileSync(claudeMdFile, "utf-8");
+    // Should have new header
+    expect(content).toContain(SECTION_HEADER);
+    // Should NOT have old header (unless they're the same)
+    if (SECTION_HEADER !== OLD_HEADER) {
+      expect(content).not.toContain(OLD_HEADER);
+    }
+    // Both entries should be preserved
+    expect(content).toContain("Old rule");
+    expect(content).toContain("New rule");
+  });
+
+  it("removes entries from old header format", () => {
+    writeFileSync(
+      claudeMdFile,
+      `# My Project\n\n${OLD_HEADER}\n\n- Old rule <!-- cf:conventions/old-rule -->\n- Keep this <!-- cf:conventions/keep -->\n`,
+    );
+
+    removeFromClaudeMd(testDir, "conventions/old-rule");
+
+    const content = readFileSync(claudeMdFile, "utf-8");
+    expect(content).not.toContain("Old rule");
+    expect(content).toContain("Keep this");
+  });
+});
+
+describe("syncToClaudeMd with non-convention categories", () => {
+  it("syncs decisions entries to CLAUDE.md", () => {
+    syncToClaudeMd(
+      testDir,
+      "decisions/api-versioning",
+      "Always use URL-based API versioning (v1, v2)",
+    );
+
+    const content = readFileSync(claudeMdFile, "utf-8");
+    expect(content).toContain(SECTION_HEADER);
+    expect(content).toContain("Always use URL-based API versioning");
+    expect(content).toContain("<!-- cf:decisions/api-versioning -->");
+  });
+
+  it("syncs infrastructure entries to CLAUDE.md", () => {
+    syncToClaudeMd(
+      testDir,
+      "infrastructure/deploy-checklist",
+      "Always run migrations before deploying",
+    );
+
+    const content = readFileSync(claudeMdFile, "utf-8");
+    expect(content).toContain("Always run migrations before deploying");
+    expect(content).toContain("<!-- cf:infrastructure/deploy-checklist -->");
+  });
+
+  it("mixes convention and non-convention entries in same section", () => {
+    syncToClaudeMd(testDir, "conventions/naming", "Use camelCase");
+    syncToClaudeMd(
+      testDir,
+      "decisions/db-choice",
+      "Use PostgreSQL for all new services",
+    );
+
+    const content = readFileSync(claudeMdFile, "utf-8");
+    expect(content).toContain("Use camelCase");
+    expect(content).toContain("Use PostgreSQL for all new services");
+    // Only one section header
+    const headerCount = content.split(SECTION_HEADER).length - 1;
+    expect(headerCount).toBe(1);
+  });
+
+  it("removes non-convention entries by ID", () => {
+    syncToClaudeMd(testDir, "decisions/api-versioning", "URL-based versioning");
+    syncToClaudeMd(testDir, "conventions/naming", "Use camelCase");
+
+    removeFromClaudeMd(testDir, "decisions/api-versioning");
+
+    const content = readFileSync(claudeMdFile, "utf-8");
+    expect(content).not.toContain("URL-based versioning");
+    expect(content).toContain("Use camelCase");
+  });
+
+  it("updates non-convention entries", () => {
+    syncToClaudeMd(testDir, "infrastructure/ci-rule", "Run lint before tests");
+
+    updateInClaudeMd(
+      testDir,
+      "infrastructure/ci-rule",
+      "Run lint and type-check before tests",
+    );
+
+    const content = readFileSync(claudeMdFile, "utf-8");
+    expect(content).toContain("Run lint and type-check before tests");
+    expect(content).not.toContain("Run lint before tests\n");
+  });
+});

package/lib/cf-memory/src/lib/claude-md.ts

@@ -14,7 +14,10 @@
 import fs from "node:fs";
 import path from "node:path";
 
-export const SECTION_HEADER = "## CF Memory: Conventions";
+export const SECTION_HEADER = "## CF Memory: Project Rules";
+
+/** @deprecated Old header — kept for migration. Removed after reading. */
+const LEGACY_HEADER = "## CF Memory: Conventions";
 
 // Tested per-line via .split("\n"), not against the full document,
 // so the $ anchor correctly matches end-of-line without the `m` flag.
@@ -52,13 +55,19 @@ function parseClaudeMd(content: string): {
   after: string;
   untrackedLines: string[];
 } {
-  const headerIdx = content.indexOf(SECTION_HEADER);
+  // Try current header first, then legacy header for migration
+  let headerIdx = content.indexOf(SECTION_HEADER);
+  let headerLen = SECTION_HEADER.length;
+  if (headerIdx === -1) {
+    headerIdx = content.indexOf(LEGACY_HEADER);
+    headerLen = LEGACY_HEADER.length;
+  }
   if (headerIdx === -1) {
     return { before: content, entries: [], after: "", untrackedLines: [] };
   }
 
   const before = content.slice(0, headerIdx);
-  const rest = content.slice(headerIdx + SECTION_HEADER.length);
+  const rest = content.slice(headerIdx + headerLen);
 
   // Find the next section header (## ) to determine where our section ends
   const nextSectionMatch = rest.match(/\n(## )/);

package/lib/cf-memory/src/tools/delete.ts

@@ -28,12 +28,12 @@ export function registerDelete(
           isError: true,
         };
       }
-      // Remove from CLAUDE.md if it was a conventions entry
-      if (id.startsWith("conventions/") && ctx?.docsDir) {
+      // Remove from CLAUDE.md (any category may have been synced via sync_to_claude_md)
+      if (ctx?.docsDir) {
         try {
           removeFromClaudeMd(ctx.docsDir, id);
         } catch {
-          // Best-effort
+          // Best-effort — removeFromClaudeMd is idempotent
         }
       }
 

package/lib/cf-memory/src/tools/store.ts

@@ -40,6 +40,14 @@ export function registerStore(
         .describe(
           "When true, skip file creation and return a Memory object for indexing. File must already exist on disk.",
         ),
+      sync_to_claude_md: z
+        .boolean()
+        .optional()
+        .describe(
+          "When true, sync this memory to the project's CLAUDE.md regardless of category. " +
+            "Use for memories containing project-wide rules, conventions, or decisions that should be visible in CLAUDE.md. " +
+            "Convention memories (type: preference) are always synced automatically.",
+        ),
     },
     async ({
       title,
@@ -50,6 +58,7 @@ export function registerStore(
       importance,
       source,
       index_only,
+      sync_to_claude_md,
     }) => {
       const input = {
         title,
@@ -73,9 +82,12 @@ export function registerStore(
 
       const memory = await backend.store(input);
 
-      // Sync convention memories to CLAUDE.md
+      // Sync to CLAUDE.md: auto for conventions, opt-in for other categories
       let claudeMdUpdated = false;
-      if (memory.category === "conventions" && ctx?.docsDir && !index_only) {
+      const shouldSync =
+        (memory.category === "conventions" || sync_to_claude_md) &&
+        ctx?.docsDir;
+      if (shouldSync) {
         try {
           syncToClaudeMd(ctx.docsDir, memory.id, description);
           claudeMdUpdated = true;

package/lib/cf-memory/src/tools/update.ts

@@ -29,8 +29,23 @@ export function registerUpdate(
         .max(5)
         .optional()
         .describe("New importance"),
+      sync_to_claude_md: z
+        .boolean()
+        .optional()
+        .describe(
+          "When true, sync this memory to the project's CLAUDE.md regardless of category. " +
+            "Convention memories (type: preference) are always synced automatically.",
+        ),
     },
-    async ({ id, title, description, tags, content, importance }) => {
+    async ({
+      id,
+      title,
+      description,
+      tags,
+      content,
+      importance,
+      sync_to_claude_md,
+    }) => {
       const memory = await backend.update({
         id,
         title,
@@ -51,9 +66,12 @@ export function registerUpdate(
         };
       }
 
-      // Sync convention memories to CLAUDE.md
+      // Sync to CLAUDE.md: auto for conventions, opt-in for other categories
       let claudeMdUpdated = false;
-      if (memory.category === "conventions" && ctx?.docsDir) {
+      const shouldSync =
+        (memory.category === "conventions" || sync_to_claude_md) &&
+        ctx?.docsDir;
+      if (shouldSync) {
         try {
           if (description) {
             // Description changed — update the CLAUDE.md entry

package/package.json

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