cralph 1.0.0-alpha.6 → 1.0.0-beta.1

package/README.md

@@ -26,13 +26,11 @@ cralph wraps this into a CLI with config, logging, and TODO tracking.
 ## Install
 
 ```bash
-bun add -g cralph
-```
+# Install Bun (if not already installed)
+curl -fsSL https://bun.sh/install | bash
 
-Or with npm:
-
-```bash
-npm install -g cralph
+# Install cralph
+bun add -g cralph
 ```
 
 ## Quick Start
@@ -142,13 +140,19 @@ Use `--yes` to skip confirmation (for CI/automation).
 - **Enter** - Confirm
 - **Ctrl+C** - Exit
 
+## Platform Notes
+
+### macOS Protected Directories
+
+cralph gracefully handles macOS permission errors (`EPERM`, `EACCES`) when scanning directories. Protected locations like `~/Pictures/Photo Booth Library` or iCloud folders are silently skipped, allowing the CLI to run from any directory including root (`/`).
+
 ## Testing
 
 ```bash
 bun test
 ```
 
-- **Unit tests** - Config, prompt building, CLI
+- **Unit tests** - Config, prompt building, CLI, access error handling
 - **E2E tests** - Full loop with Claude (requires auth)
 
 ## Requirements

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cralph",
-  "version": "1.0.0-alpha.6",
+  "version": "1.0.0-beta.1",
   "description": "Claude in a loop. Point at refs, give it a rule, let it cook.",
   "author": "mguleryuz",
   "license": "MIT",

package/src/paths.ts

@@ -11,10 +11,29 @@ const CONTROLS = dim("↑↓ Navigate • Space Toggle • Enter • Ctrl+C Exit
  * List directories in a given path
  */
 async function listDirectories(basePath: string): Promise<string[]> {
-  const entries = await readdir(basePath, { withFileTypes: true });
-  return entries
-    .filter((e) => e.isDirectory() && !e.name.startsWith("."))
-    .map((e) => e.name);
+  try {
+    const entries = await readdir(basePath, { withFileTypes: true });
+    return entries
+      .filter((e) => e.isDirectory() && !e.name.startsWith("."))
+      .map((e) => e.name);
+  } catch (error) {
+    // Silently skip directories we can't access (EPERM, EACCES)
+    if (isAccessError(error)) {
+      return [];
+    }
+    throw error;
+  }
+}
+
+/**
+ * Check if an error is a permission/access error
+ */
+export function isAccessError(error: unknown): boolean {
+  if (error && typeof error === "object" && "code" in error) {
+    const code = (error as { code: string }).code;
+    return code === "EPERM" || code === "EACCES";
+  }
+  return false;
 }
 
 /**
@@ -37,7 +56,7 @@ const EXCLUDED_DIRS = [
 /**
  * List directories recursively up to a certain depth
  */
-async function listDirectoriesRecursive(
+export async function listDirectoriesRecursive(
   basePath: string,
   maxDepth: number = 3
 ): Promise<string[]> {
@@ -46,7 +65,17 @@ async function listDirectoriesRecursive(
   async function walk(dir: string, depth: number) {
     if (depth > maxDepth) return;
     
-    const entries = await readdir(dir, { withFileTypes: true });
+    let entries;
+    try {
+      entries = await readdir(dir, { withFileTypes: true });
+    } catch (error) {
+      // Silently skip directories we can't access (EPERM, EACCES)
+      if (isAccessError(error)) {
+        return;
+      }
+      throw error;
+    }
+    
     for (const entry of entries) {
       // Skip hidden and excluded directories
       if (!entry.isDirectory()) continue;
@@ -66,14 +95,24 @@ async function listDirectoriesRecursive(
 /**
  * List files matching patterns in a directory (recursive)
  */
-async function listFilesRecursive(
+export async function listFilesRecursive(
   basePath: string,
   extensions: string[]
 ): Promise<string[]> {
   const results: string[] = [];
 
   async function walk(dir: string) {
-    const entries = await readdir(dir, { withFileTypes: true });
+    let entries;
+    try {
+      entries = await readdir(dir, { withFileTypes: true });
+    } catch (error) {
+      // Silently skip directories we can't access (EPERM, EACCES)
+      if (isAccessError(error)) {
+        return;
+      }
+      throw error;
+    }
+    
     for (const entry of entries) {
       const fullPath = join(dir, entry.name);
       if (entry.isDirectory()) {