cccmemory 1.8.0

package/dist/utils/safeJson.js

@@ -0,0 +1,48 @@
+/**
+ * Safe JSON parsing utilities
+ *
+ * Provides crash-safe JSON parsing with fallback values.
+ * Use this instead of raw JSON.parse() when parsing data from:
+ * - Database rows (may be corrupted)
+ * - User input
+ * - External sources
+ */
+/**
+ * Safely parse JSON with a fallback value on error.
+ *
+ * Unlike JSON.parse(), this function:
+ * - Never throws
+ * - Handles null/undefined input
+ * - Handles non-string input
+ * - Returns the fallback on any parse error
+ *
+ * @param value - The JSON string to parse
+ * @param fallback - Value to return if parsing fails
+ * @returns Parsed value or fallback
+ *
+ * @example
+ * ```typescript
+ * // Safe object parsing
+ * const data = safeJsonParse(row.metadata, {});
+ *
+ * // Safe array parsing
+ * const files = safeJsonParse(row.files_changed, []);
+ *
+ * // With specific type
+ * interface Config { debug: boolean }
+ * const config = safeJsonParse<Config>(jsonStr, { debug: false });
+ * ```
+ */
+export function safeJsonParse(value, fallback) {
+    // Handle non-string input
+    if (typeof value !== "string" || value === "") {
+        return fallback;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch (_error) {
+        return fallback;
+    }
+}
+//# sourceMappingURL=safeJson.js.map

package/dist/utils/safeJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeJson.js","sourceRoot":"","sources":["../../src/utils/safeJson.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,aAAa,CAAI,KAAgC,EAAE,QAAW;IAC5E,0BAA0B;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC9C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAChC,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/utils/sanitization.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Input sanitization utilities for SQL LIKE queries and path validation
+ */
+/**
+ * Sanitize string for use in SQL LIKE patterns
+ * Escapes special LIKE characters: %, _, "
+ */
+export declare function sanitizeForLike(input: string): string;
+/**
+ * Validate and sanitize file path
+ * Cross-platform: prevents path traversal attacks and blocks system directories
+ */
+export declare function validateFilePath(filePath: string): string;
+/**
+ * Validate and normalize project path
+ * Cross-platform: handles both Unix (/) and Windows (\) paths
+ * Used for converting file paths to Claude project directory names
+ */
+export declare function sanitizeProjectPath(path: string): string;
+/**
+ * Sanitize SQL identifier (table/column name)
+ * Only allows alphanumeric and underscore
+ */
+export declare function sanitizeSQLIdentifier(identifier: string): string;
+/**
+ * Escape a table name for use in double-quoted SQL identifiers
+ * Doubles any embedded double-quotes per SQL standard
+ */
+export declare function escapeTableName(tableName: string): string;
+/**
+ * Validate database path for use in ATTACH DATABASE statement
+ * Prevents SQL injection via path manipulation
+ */
+export declare function validateDatabasePath(dbPath: string): string;
+/**
+ * Convert a project path to Claude Code's project folder name
+ * Cross-platform compatible - handles both Unix and Windows paths
+ *
+ * Examples:
+ * - macOS/Linux: /Users/joker/github/project → -Users-joker-github-project
+ * - Windows: C:\Users\user\project → C-Users-user-project
+ * - Windows UNC: \\server\share\project → -server-share-project
+ */
+export declare function pathToProjectFolderName(projectPath: string): string;
+//# sourceMappingURL=sanitization.d.ts.map

package/dist/utils/sanitization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitization.d.ts","sourceRoot":"","sources":["../../src/utils/sanitization.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAYD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+CzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqB3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAWnE"}

package/dist/utils/sanitization.js

@@ -0,0 +1,153 @@
+/**
+ * Input sanitization utilities for SQL LIKE queries and path validation
+ */
+import { normalize, sep } from 'path';
+/**
+ * Sanitize string for use in SQL LIKE patterns
+ * Escapes special LIKE characters: %, _, "
+ */
+export function sanitizeForLike(input) {
+    return input.replace(/[%_"\\]/g, '\\$&');
+}
+/**
+ * Check if a path contains path traversal attempts
+ * Only rejects actual '..' path segments, not filenames containing '..'
+ */
+function hasPathTraversal(pathStr) {
+    // Split on both Unix and Windows separators
+    const segments = pathStr.split(/[\\/]/);
+    return segments.some(segment => segment === '..');
+}
+/**
+ * Validate and sanitize file path
+ * Cross-platform: prevents path traversal attacks and blocks system directories
+ */
+export function validateFilePath(filePath) {
+    // Remove any null bytes
+    const cleaned = filePath.replace(/\0/g, '');
+    // Check for path traversal attempts (only actual '..' segments)
+    if (hasPathTraversal(cleaned)) {
+        throw new Error('Path traversal detected: .. is not allowed in file paths');
+    }
+    // Check for absolute paths outside allowed directories (platform-specific)
+    const isWindows = process.platform === 'win32';
+    if (isWindows) {
+        // Windows system directories (case-insensitive)
+        const forbidden = [
+            /^[A-Z]:\\Windows\\/i,
+            /^[A-Z]:\\Program Files/i,
+            /^[A-Z]:\\ProgramData/i,
+            /^[A-Z]:\\System/i,
+            /^[A-Z]:\\System32/i,
+            /^[A-Z]:\\Boot/i,
+        ];
+        if (forbidden.some(pattern => pattern.test(cleaned))) {
+            throw new Error('Access to system directories is not allowed');
+        }
+    }
+    else {
+        // Unix system directories - comprehensive list
+        const forbiddenPaths = [
+            '/etc',
+            '/sys',
+            '/proc',
+            '/dev',
+            '/boot',
+            '/sbin',
+            '/bin',
+            '/lib',
+            '/lib64',
+            '/usr/sbin',
+            '/var/run',
+            '/var/lock',
+        ];
+        if (forbiddenPaths.some(dir => cleaned === dir || cleaned.startsWith(dir + '/'))) {
+            throw new Error('Access to system directories is not allowed');
+        }
+    }
+    return cleaned;
+}
+/**
+ * Validate and normalize project path
+ * Cross-platform: handles both Unix (/) and Windows (\) paths
+ * Used for converting file paths to Claude project directory names
+ */
+export function sanitizeProjectPath(path) {
+    // Remove null bytes
+    const cleaned = path.replace(/\0/g, '');
+    // Check for path traversal
+    if (cleaned.includes('..')) {
+        throw new Error('Path traversal detected in project path');
+    }
+    // First normalize with Node's native path module for current platform
+    let normalized = normalize(cleaned);
+    // Then handle any remaining separators from other platforms
+    // Replace multiple consecutive slashes/backslashes with single separator
+    normalized = normalized.replace(/[\\/]+/g, sep);
+    // Remove trailing path separator
+    const trailingSepRegex = new RegExp(`${sep.replace(/\\/g, '\\\\')}+$`);
+    return normalized.replace(trailingSepRegex, '');
+}
+/**
+ * Sanitize SQL identifier (table/column name)
+ * Only allows alphanumeric and underscore
+ */
+export function sanitizeSQLIdentifier(identifier) {
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(identifier)) {
+        throw new Error(`Invalid SQL identifier: ${identifier}`);
+    }
+    return identifier;
+}
+/**
+ * Escape a table name for use in double-quoted SQL identifiers
+ * Doubles any embedded double-quotes per SQL standard
+ */
+export function escapeTableName(tableName) {
+    if (!tableName || tableName.length === 0) {
+        throw new Error("Table name cannot be empty");
+    }
+    // Double any embedded double-quotes (SQL standard escaping)
+    return tableName.replace(/"/g, '""');
+}
+/**
+ * Validate database path for use in ATTACH DATABASE statement
+ * Prevents SQL injection via path manipulation
+ */
+export function validateDatabasePath(dbPath) {
+    if (!dbPath || dbPath.length === 0) {
+        throw new Error("Database path cannot be empty");
+    }
+    // Check for single quotes which could break SQL string
+    if (dbPath.includes("'")) {
+        throw new Error("Database path cannot contain single quotes");
+    }
+    // Check for null bytes
+    if (dbPath.includes("\0")) {
+        throw new Error("Database path cannot contain null bytes");
+    }
+    // Check for path traversal
+    if (dbPath.includes("..")) {
+        throw new Error("Path traversal detected in database path");
+    }
+    return dbPath;
+}
+/**
+ * Convert a project path to Claude Code's project folder name
+ * Cross-platform compatible - handles both Unix and Windows paths
+ *
+ * Examples:
+ * - macOS/Linux: /Users/joker/github/project → -Users-joker-github-project
+ * - Windows: C:\Users\user\project → C-Users-user-project
+ * - Windows UNC: \\server\share\project → -server-share-project
+ */
+export function pathToProjectFolderName(projectPath) {
+    // Normalize the path first
+    const normalized = sanitizeProjectPath(projectPath);
+    // Replace Windows drive letters (C: → C, D: → D)
+    // Replace both forward and backward slashes with dashes
+    const folderName = normalized
+        .replace(/^([A-Z]):/i, '$1') // Remove colon from drive letter
+        .replace(/[\\/]+/g, '-'); // Replace / or \ with -
+    return folderName;
+}
+//# sourceMappingURL=sanitization.js.map

package/dist/utils/sanitization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitization.js","sourceRoot":"","sources":["../../src/utils/sanitization.ts"],"names":[],"mappings":"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"}

package/dist/utils/worktree.d.ts

@@ -0,0 +1,15 @@
+export interface WorktreeInfo {
+    canonicalPath: string;
+    worktreePaths: string[];
+    isGitRepo: boolean;
+    commonDir?: string;
+}
+export declare function getGitCommonDir(projectPath: string): string | null;
+export declare function getCanonicalProjectPath(projectPath: string): {
+    canonicalPath: string;
+    commonDir?: string;
+    isGitRepo: boolean;
+};
+export declare function listWorktreePaths(projectPath: string): string[];
+export declare function getWorktreeInfo(projectPath: string): WorktreeInfo;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/utils/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/utils/worktree.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA4BD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG;IAC5D,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB,CAYA;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB/D;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAiBjE"}

package/dist/utils/worktree.js

@@ -0,0 +1,86 @@
+import { execFileSync } from "child_process";
+import { basename, dirname, isAbsolute, resolve } from "path";
+import { realpathSync } from "fs";
+function normalizePath(inputPath) {
+    const resolved = resolve(inputPath);
+    try {
+        return realpathSync(resolved);
+    }
+    catch (_error) {
+        return resolved;
+    }
+}
+function runGit(args, cwd) {
+    try {
+        return execFileSync("git", args, {
+            cwd,
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+    }
+    catch (_error) {
+        return null;
+    }
+}
+function resolveGitPath(rawPath, cwd) {
+    const resolved = isAbsolute(rawPath) ? rawPath : resolve(cwd, rawPath);
+    return normalizePath(resolved);
+}
+export function getGitCommonDir(projectPath) {
+    const normalizedProjectPath = normalizePath(projectPath);
+    const output = runGit(["rev-parse", "--git-common-dir"], normalizedProjectPath);
+    if (!output) {
+        return null;
+    }
+    return resolveGitPath(output, normalizedProjectPath);
+}
+export function getCanonicalProjectPath(projectPath) {
+    const normalizedProjectPath = normalizePath(projectPath);
+    const commonDir = getGitCommonDir(normalizedProjectPath);
+    if (!commonDir) {
+        return { canonicalPath: normalizedProjectPath, isGitRepo: false };
+    }
+    const commonBase = basename(commonDir);
+    const canonicalPath = commonBase === ".git" ? normalizePath(dirname(commonDir)) : commonDir;
+    return { canonicalPath, commonDir, isGitRepo: true };
+}
+export function listWorktreePaths(projectPath) {
+    const normalizedProjectPath = normalizePath(projectPath);
+    const output = runGit(["worktree", "list", "--porcelain"], normalizedProjectPath);
+    if (!output) {
+        return [];
+    }
+    const worktrees = [];
+    for (const line of output.split(/\r?\n/)) {
+        if (!line.startsWith("worktree ")) {
+            continue;
+        }
+        const rawPath = line.slice("worktree ".length).trim();
+        if (!rawPath) {
+            continue;
+        }
+        const resolved = resolveGitPath(rawPath, normalizedProjectPath);
+        if (!worktrees.includes(resolved)) {
+            worktrees.push(resolved);
+        }
+    }
+    return worktrees;
+}
+export function getWorktreeInfo(projectPath) {
+    const normalizedProjectPath = normalizePath(projectPath);
+    const { canonicalPath, commonDir, isGitRepo } = getCanonicalProjectPath(normalizedProjectPath);
+    let worktreePaths = listWorktreePaths(normalizedProjectPath);
+    if (worktreePaths.length === 0) {
+        worktreePaths = [normalizedProjectPath];
+    }
+    else if (!worktreePaths.includes(normalizedProjectPath)) {
+        worktreePaths.push(normalizedProjectPath);
+    }
+    return {
+        canonicalPath,
+        worktreePaths,
+        isGitRepo,
+        commonDir,
+    };
+}
+//# sourceMappingURL=worktree.js.map

package/dist/utils/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../../src/utils/worktree.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "cccmemory",
+  "version": "1.8.0",
+  "description": "MCP server for indexing and searching Claude Code conversation history with decision tracking, git integration, and project migration/merge",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "cccmemory": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && npm run postbuild",
+    "postbuild": "cp src/storage/schema.sql dist/storage/",
+    "preinstall": "node scripts/check-node.js",
+    "postinstall": "node scripts/postinstall.js",
+    "dev": "tsc --watch",
+    "dev:config": "node scripts/dev-config.js",
+    "start": "node dist/index.js",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "docs": "typedoc --out docs src",
+    "test:watch": "npm test -- --watch",
+    "test:coverage": "npm test -- --coverage",
+    "changelog:check": "bash scripts/changelog-check.sh",
+    "pre-push": "npm run type-check && npm run lint && npm run build",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "conversation",
+    "memory",
+    "semantic-search",
+    "decision-tracking"
+  ],
+  "author": "xiaolai",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xiaolai/cccmemory.git"
+  },
+  "bugs": {
+    "url": "https://github.com/xiaolai/cccmemory/issues"
+  },
+  "homepage": "https://github.com/xiaolai/cccmemory#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@xenova/transformers": "^2.17.2",
+    "better-sqlite3": "^11.10.0",
+    "chalk": "^5.3.0",
+    "chokidar": "^5.0.0",
+    "cli-table3": "^0.6.5",
+    "commander": "^12.1.0",
+    "lru-cache": "^10.0.0",
+    "nanoid": "^5.0.0",
+    "prompts": "^2.4.2",
+    "simple-git": "^3.25.0",
+    "sqlite-vec": "^0.1.6"
+  },
+  "optionalDependencies": {
+    "openai": "^6.9.1"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.5",
+    "@types/prompts": "^2.4.9",
+    "@typescript-eslint/eslint-plugin": "^8.19.1",
+    "@typescript-eslint/parser": "^8.19.1",
+    "eslint": "^9.18.0",
+    "globals": "^16.5.0",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "lint-staged": "^16.2.6",
+    "prettier": "^3.6.2",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=20 <23"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  }
+}

package/scripts/changelog-check.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+# Changelog checker - Verifies CHANGELOG.md is up to date for releases
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Get the current version from package.json
+CURRENT_VERSION=$(node -p "require('./package.json').version")
+
+# Check if CHANGELOG.md exists
+if [ ! -f "CHANGELOG.md" ]; then
+  echo -e "${RED}❌ CHANGELOG.md not found${NC}"
+  exit 1
+fi
+
+# Check if current version is documented in CHANGELOG
+if ! grep -q "\[$CURRENT_VERSION\]" CHANGELOG.md; then
+  echo -e "${YELLOW}⚠️  Warning: Version $CURRENT_VERSION not found in CHANGELOG.md${NC}"
+  echo ""
+  echo "Please add an entry for version $CURRENT_VERSION to CHANGELOG.md"
+  echo ""
+  echo "Template:"
+  echo "----------------------------------------"
+  echo "## [$CURRENT_VERSION] - $(date +%Y-%m-%d)"
+  echo ""
+  echo "### Added"
+  echo "- New feature description"
+  echo ""
+  echo "### Changed"
+  echo "- Changed functionality description"
+  echo ""
+  echo "### Fixed"
+  echo "- Bug fix description"
+  echo "----------------------------------------"
+  echo ""
+  exit 1
+fi
+
+# Check if [Unreleased] section has content
+UNRELEASED_CONTENT=$(sed -n '/## \[Unreleased\]/,/## \[[0-9]/p' CHANGELOG.md | grep -v "^## " | grep -v "^$" | wc -l)
+
+if [ "$UNRELEASED_CONTENT" -gt 0 ]; then
+  echo -e "${YELLOW}⚠️  [Unreleased] section has content${NC}"
+  echo ""
+  echo "Remember to move unreleased changes to the versioned section before releasing"
+  echo ""
+fi
+
+# Success
+echo -e "${GREEN}✅ CHANGELOG.md looks good for version $CURRENT_VERSION${NC}"
+
+# Show recent entries
+echo ""
+echo "Recent entries:"
+echo "----------------------------------------"
+sed -n '/## \['$CURRENT_VERSION'\]/,/^## /p' CHANGELOG.md | head -20
+echo "----------------------------------------"

package/scripts/check-node.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/* eslint-env node */
+/* eslint-disable no-console */
+
+const rawVersion = process.versions.node || "0.0.0";
+const major = Number(rawVersion.split(".")[0] || 0);
+const minMajor = 20;
+const maxMajorExclusive = 23;
+
+if (Number.isNaN(major) || major < minMajor || major >= maxMajorExclusive) {
+  console.error("❌ cccmemory supports Node.js 20 or 22 LTS only.");
+  console.error(`   Detected Node.js ${rawVersion}.`);
+  console.error("   Please switch to Node 20/22 and reinstall:");
+  console.error("   - nvm install 22 && nvm use 22");
+  console.error("   - npm install -g cccmemory");
+  process.exit(1);
+}

package/scripts/dev-config.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * Generate MCP configuration for local development testing.
+ *
+ * Usage: npm run dev:config
+ *
+ * This outputs the JSON configuration to add to your Claude Code settings
+ * for testing the local build instead of the published npm package.
+ */
+
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const projectRoot = resolve(__dirname, "..");
+const entryPoint = resolve(projectRoot, "dist", "index.js");
+
+const config = {
+  "cccmemory": {
+    command: "node",
+    args: [entryPoint],
+  },
+};
+
+console.log(`
+╔══════════════════════════════════════════════════════════════════╗
+║           Local Development MCP Configuration                    ║
+╚══════════════════════════════════════════════════════════════════╝
+
+Add this to your Claude Code MCP settings (~/.claude.json or VS Code settings):
+
+${JSON.stringify({ mcpServers: config }, null, 2)}
+
+Or just the server entry:
+
+${JSON.stringify(config, null, 2)}
+
+────────────────────────────────────────────────────────────────────
+Entry point: ${entryPoint}
+
+Steps to test local changes:
+1. Make your code changes
+2. Run: npm run build
+3. Restart Claude Code (Cmd+Shift+P > "Developer: Reload Window" in VS Code)
+4. Test your changes
+
+To switch back to published version, use:
+{
+  "cccmemory": {
+    "command": "npx",
+    "args": ["-y", "cccmemory"]
+  }
+}
+────────────────────────────────────────────────────────────────────
+`);