@claudetools/tools 0.3.4 → 0.3.5

package/dist/helpers/config.d.ts

@@ -14,7 +14,8 @@ export interface ProjectsCache {
     last_sync: string;
 }
 /**
- * Validates that a project ID is a proper UUID format
+ * Validates that a project ID is in a valid format
+ * Accepts both API-registered (proj_*) and local fallback (local_*) formats
  */
 export declare function isValidProjectId(id: string): boolean;
 /**

package/dist/helpers/config.js

@@ -13,10 +13,19 @@ export const PROJECTS_FILE = getProjectsPath();
 // Cache for resolved project ID
 let resolvedProjectId = null;
 /**
- * Validates that a project ID is a proper UUID format
+ * Validates that a project ID is in a valid format
+ * Accepts both API-registered (proj_*) and local fallback (local_*) formats
  */
 export function isValidProjectId(id) {
-    return /^proj_[a-f0-9]{20}$/.test(id);
+    // API-registered format: proj_ followed by 20 hex chars
+    if (/^proj_[a-f0-9]{20}$/.test(id)) {
+        return true;
+    }
+    // Local fallback format: local_ followed by sanitized project name
+    if (/^local_[a-z0-9_]+$/.test(id)) {
+        return true;
+    }
+    return false;
 }
 /**
  * Finds a project binding in the cache by directory path
@@ -78,7 +87,7 @@ export async function resolveProjectIdAsync() {
         // Validate UUID format
         if (!isValidProjectId(envProjectId)) {
             throw new Error(`Invalid project ID format in CLAUDETOOLS_PROJECT_ID: ${envProjectId}. ` +
-                `Expected format: proj_xxxxxxxxxxxxxxxxxxxx (20 hex chars)`);
+                `Expected format: proj_xxxxxxxxxxxxxxxxxxxx or local_projectname`);
         }
         resolvedProjectId = envProjectId;
         mcpLogger.debug('MEMORY', `Using project ID from env: ${resolvedProjectId}`);
@@ -135,7 +144,7 @@ export function getDefaultProjectId() {
     if (config.defaultProjectId) {
         if (!isValidProjectId(config.defaultProjectId)) {
             throw new Error(`Invalid defaultProjectId in config: ${config.defaultProjectId}. ` +
-                `Expected format: proj_xxxxxxxxxxxxxxxxxxxx (20 hex chars)`);
+                `Expected format: proj_xxxxxxxxxxxxxxxxxxxx or local_projectname`);
         }
         _defaultProjectId = config.defaultProjectId;
         return _defaultProjectId;
@@ -155,7 +164,7 @@ export async function getDefaultProjectIdAsync() {
     if (config.defaultProjectId) {
         if (!isValidProjectId(config.defaultProjectId)) {
             throw new Error(`Invalid defaultProjectId in config: ${config.defaultProjectId}. ` +
-                `Expected format: proj_xxxxxxxxxxxxxxxxxxxx (20 hex chars)`);
+                `Expected format: proj_xxxxxxxxxxxxxxxxxxxx or local_projectname`);
         }
         _defaultProjectId = config.defaultProjectId;
         return _defaultProjectId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudetools/tools",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Persistent AI memory, task management, and codebase intelligence for Claude Code",
   "type": "module",
   "main": "dist/index.js",