pi-lens 1.2.0 → 1.3.1

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to pi-lens will be documented in this file.
+
+## [1.3.0] - 2026-03-23
+
+### Changed
+- **Biome auto-fix disabled by default**: Biome still provides linting feedback, but no longer auto-fixes on write. Use `/format` to apply fixes or enable with `--autofix-biome`.
+
+### Added
+- **ast-grep search/replace tools**: New `ast_grep_search` and `ast_grep_replace` tools for AST-aware code pattern matching. Supports meta-variables and 24 languages.
+- **Rule descriptions in diagnostics**: ast-grep violations now include the rule's message and note, making feedback more actionable for the agent.
+
+### Changed
+- **Reduced console noise**: Extension no longer prints to console by default. Enable with `--lens-verbose`.
+
+## [1.2.0] - 2026-03-23
+
+### Added
+- GitHub repository link in npm package
+
+## [1.1.2] - Previous
+
+- See git history for earlier releases

package/README.md

@@ -104,7 +104,7 @@ pip install ruff
 
 | Flag | Default | Description |
 |---|---|---|
-| `--autofix-biome` | **`true`** | Auto-fix Biome lint/format issues on every write |
+| `--autofix-biome` | `false` | Auto-fix Biome lint/format issues on every write |
 | `--autofix-ruff` | **`true`** | Auto-fix Ruff issues on every write |
 | `--no-biome` | `false` | Disable Biome |
 | `--no-ast-grep` | `false` | Disable ast-grep |

package/index.ts

@@ -10,9 +10,9 @@
  * Proactive hints before write/edit:
  * - Warns when target file already has existing violations
  *
- * Auto-fix on write (enable with autofix-biome / autofix-ruff flags):
- * - Biome: applies --write --unsafe (lint + format fixes)
- * - Ruff: applies --fix + format (lint + format fixes)
+	 * Auto-fix on write (enable with --autofix-ruff flag, Biome auto-fix disabled by default):
+	 * - Biome: feedback only by default, use /format to apply fixes
+	 * - Ruff: applies --fix + format (lint + format fixes)
  *
  * On-demand commands:
  * - /format - Apply Biome formatting
@@ -115,7 +115,7 @@ export default function (pi: ExtensionAPI) {
 		description:
 			"Auto-fix Biome lint/format issues on write (applies --write --unsafe)",
 		type: "boolean",
-		default: true,
+		default: false,
 	});
 
 	pi.registerFlag("autofix-ruff", {
@@ -263,11 +263,12 @@ export default function (pi: ExtensionAPI) {
 	pi.registerTool({
 		name: "ast_grep_search",
 		label: "AST Search",
-		description: "Search code patterns using AST-aware matching. Use meta-variables: $VAR (single node), $$$ (multiple). Examples: 'console.log($MSG)', 'def $FUNC($$$):'",
+		description: "Search code using AST-aware pattern matching. IMPORTANT: Use specific AST patterns, NOT text search. Examples:\n- Find function: 'function $NAME() { $$$BODY }'\n- Find call: 'fetchMetrics($ARGS)'\n- Find import: 'import { $NAMES } from \"$PATH\"'\n- Generic identifier (broad): 'fetchMetrics'\n\nAlways prefer specific patterns with context over bare identifiers. Use 'paths' to scope to specific files/folders.",
+		promptSnippet: "Use ast_grep_search for AST-aware code search",
 		parameters: Type.Object({
-			pattern: Type.String({ description: "AST pattern with meta-variables" }),
+			pattern: Type.String({ description: "AST pattern (use function/class/call context, not text)" }),
 			lang: Type.Union(LANGUAGES.map((l) => Type.Literal(l)), { description: "Target language" }),
-			paths: Type.Optional(Type.Array(Type.String(), { description: "Paths to search (default: .)" })),
+			paths: Type.Optional(Type.Array(Type.String(), { description: "Specific files/folders to search" })),
 		}),
 		async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
 			if (!astGrepClient.isAvailable()) {
@@ -290,12 +291,13 @@ export default function (pi: ExtensionAPI) {
 	pi.registerTool({
 		name: "ast_grep_replace",
 		label: "AST Replace",
-		description: "Replace code patterns with AST-aware rewriting. Dry-run by default (preview changes). Use apply=true to apply. Example: pattern='console.log($MSG)' rewrite='logger.info($MSG)'",
+		description: "Replace code using AST-aware pattern matching. IMPORTANT: Use specific AST patterns, not text. Dry-run by default (use apply=true to apply).\n\nExamples:\n- pattern='console.log($MSG)' rewrite='logger.info($MSG)'\n- pattern='var $X' rewrite='let $X'\n- pattern='function $NAME() { }' rewrite='' (delete)\n\nAlways use 'paths' to scope to specific files/folders. Dry-run first to preview changes.",
+		promptSnippet: "Use ast_grep_replace for AST-aware find-and-replace",
 		parameters: Type.Object({
-			pattern: Type.String({ description: "AST pattern to match" }),
-			rewrite: Type.String({ description: "Replacement pattern" }),
+			pattern: Type.String({ description: "AST pattern to match (be specific with context)" }),
+			rewrite: Type.String({ description: "Replacement using meta-variables from pattern" }),
 			lang: Type.Union(LANGUAGES.map((l) => Type.Literal(l)), { description: "Target language" }),
-			paths: Type.Optional(Type.Array(Type.String(), { description: "Paths to search (default: .)" })),
+			paths: Type.Optional(Type.Array(Type.String(), { description: "Specific files/folders" })),
 			apply: Type.Optional(Type.Boolean({ description: "Apply changes (default: false)" })),
 		}),
 		async execute(_toolCallId, params, _signal, _onUpdate, ctx) {

package/package.json

@@ -1,8 +1,11 @@
 {
 	"name": "pi-lens",
-	"version": "1.2.0",
+	"version": "1.3.1",
 	"description": "Real-time code feedback for pi — TypeScript LSP, Biome, ast-grep, Ruff, TODO scanner, dead code, duplicate detection, type coverage",
-	"repository": "github:apmantza/pi-lens",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/apmantza/pi-lens.git"
+	},
 	"main": "index.ts",
 	"scripts": {
 		"build": "tsc",
@@ -30,7 +33,8 @@
 		"clients/",
 		"rules/",
 		"tsconfig.json",
-		"README.md"
+		"README.md",
+		"CHANGELOG.md"
 	],
 	"peerDependencies": {
 		"@mariozechner/pi-coding-agent": "*"