@liendev/lien 0.16.0 → 0.18.0

package/CURSOR_RULES_TEMPLATE.md

@@ -17,6 +17,7 @@ You have access to Lien semantic search tools. USE THEM INSTEAD OF grep/ripgrep/
 | "Find all Controllers" | `list_functions` | grep |
 | Edit a file | `get_files_context` FIRST | direct edit |
 | Find similar code | `find_similar` | manual search |
+| "What depends on this file?" | `get_dependents` | manual grep |
 
 ## Before ANY Code Change
 
@@ -35,9 +36,11 @@ REQUIRED sequence:
 
 **`get_files_context({ filepaths: "path/to/file.ts" })`** or **`get_files_context({ filepaths: ["file1.ts", "file2.ts"] })`**
 - MANDATORY before editing any file
-- Returns `testAssociations`: which tests cover this file
+- Returns `testAssociations`: which tests import/cover this file (reverse dependency lookup)
 - Shows file dependencies and relationships
 - Accepts single filepath or array of filepaths for batch operations
+- Single file returns: `{ file: string, chunks: [], testAssociations: [] }`
+- Multiple files returns: `{ files: { [path]: { chunks: [], testAssociations: [] } } }`
 
 **`list_functions({ pattern: ".*Controller.*" })`**
 - Fast symbol lookup by naming pattern
@@ -48,11 +51,30 @@ REQUIRED sequence:
 - Find similar implementations for consistency
 - Use when refactoring or detecting duplication
 
+**`get_dependents({ filepath: "path/to/file.ts", depth: 1 })`**
+- Find all files that import/depend on a target file
+- Use for impact analysis: "What breaks if I change this?"
+- Returns risk level (low/medium/high/critical) based on:
+  - Dependency count (how many files import it)
+  - Complexity metrics (how complex the dependent code is)
+- Highlights top 5 most complex dependents when complexity data available
+
 ## Test Associations
 
-`get_files_context` returns `testAssociations` showing which tests cover the file.
-ALWAYS check this before modifying source code.
-After changes, remind the user: "This file is covered by [test files] - run these to verify."
+`get_files_context` returns `testAssociations` showing which tests import/cover the file.
+- Uses reverse dependency lookup to find test files that import the source file
+- Returns array of test file paths for each requested file
+- ALWAYS check this before modifying source code
+- After changes, remind the user: "This file is covered by [test files] - run these to verify."
+
+Example:
+```typescript
+get_files_context({ filepaths: "src/auth.ts" })
+// Returns: { file: "src/auth.ts", chunks: [...], testAssociations: ["src/__tests__/auth.test.ts"] }
+
+get_files_context({ filepaths: ["src/auth.ts", "src/user.ts"] })
+// Returns: { files: { "src/auth.ts": { chunks: [...], testAssociations: [...] }, ... } }
+```
 
 ## Workflow Patterns
 
@@ -73,6 +95,15 @@ After changes, remind the user: "This file is covered by [test files] - run thes
 5. Tell user which tests to run
 ```
 
+### Pattern 3: Impact Analysis Before Refactoring
+```
+1. get_dependents({ filepath: "target/file.ts" })
+2. Review risk level and dependent count
+3. Check highComplexityDependents (if any)
+4. Use get_files_context on high-risk dependents
+5. Plan refactoring strategy based on impact
+```
+
 ## Query Construction
 
 ### Good Queries (DO THIS)