Cursor rule

1---
2description:
3globs:
4alwaysApply: false
5---
6# Resolve PNPM Build Script Issues for Trusted Dependencies
7 
8**Your task: When `pnpm` blocks essential build scripts from trusted dependencies during installation or execution, apply one of the following solutions.**
9 
10## File Existence Check
11 
12Determine if `package.json` is present before modifying it:
13 
14```bash
15ls . docs
16```
17 
18Proceed according to the result.
19 
20This typically occurs because `pnpm` defaults to not running build scripts for security reasons. For well-known and trusted libraries, you may need to explicitly allow them.
21 
22## Solutions:
23 
241.  **Allow Specific Dependencies via `package.json`:**
25    To permanently allow build scripts for specific, trusted dependencies, modify your `package.json` file by adding or updating the `pnpm.onlyBuiltDependencies` field. This is the preferred method for ongoing project configurations.
26 
27    **Example (`package.json`):**
28```json
29    {
30      // ... other package.json content
31      "pnpm": {
32        "onlyBuiltDependencies": [
33          "sqlite3",
34          "another-trusted-dependency-requiring-build"
35        ]
36      }
37      // ... rest of package.json content
38    }
39```
40    *This tells pnpm to allow build scripts specifically for `sqlite3` and `another-trusted-dependency-requiring-build`.*
41 
422.  **Temporarily Allow All Build Scripts During Installation (Use with Caution):**
43    For a one-time installation where you need to allow all build scripts (e.g., when installing many new, trusted dependencies that require building), you can use the `--dangerously-allow-all-builds` flag with the install command.
44 
45    **Command:**
46```bash
47    pnpm install --dangerously-allow-all-builds
48```
49    - **Warning:** This flag bypasses a security feature. Use it only when you trust all dependencies being installed or built. Prefer Solution 1 for specific, ongoing needs.*
50 
51**REMEMBER: Apply these solutions when `pnpm`'s security measures prevent necessary build scripts from *trusted* dependencies from running. Prioritize the `package.json` configuration for persistent allowances.**
52