@claudetools/tools 0.3.3 → 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/dist/setup.js

@@ -527,10 +527,11 @@ PROJECT_ID=""
 PROJECT_NAME=""
 
 if [ -f "$PROJECTS_FILE" ]; then
-  # Find project by path prefix match
-  PROJECT_DATA=$(jq -r --arg cwd "$CWD" '
-    .bindings[]? | select(.local_path != null) |
-    select($cwd | startswith(.local_path)) |
+  # Find project by path prefix match (use variable binding for jq startswith)
+  # Use -c for compact output so head -1 gets complete JSON object
+  PROJECT_DATA=$(jq -c --arg cwd "$CWD" '
+    .bindings[]? | select(.local_path) |
+    . as $b | select($cwd | startswith($b.local_path)) |
     {project_id, project_name}' "$PROJECTS_FILE" 2>/dev/null | head -1)
 
   if [ -n "$PROJECT_DATA" ]; then
@@ -626,10 +627,10 @@ CWD=$(pwd)
 PROJECT_ID=""
 
 if [ -f "$PROJECT_FILE" ]; then
-  # Try to find project by path prefix
+  # Try to find project by path prefix (use variable binding for jq startswith)
   PROJECT_ID=$(jq -r --arg cwd "$CWD" '
-    .bindings[]? | select(.local_path != null) |
-    select($cwd | startswith(.local_path)) |
+    .bindings[]? | select(.local_path) |
+    . as $b | select($cwd | startswith($b.local_path)) |
     .project_id' "$PROJECT_FILE" 2>/dev/null | head -1)
 fi
 

package/package.json

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