@user231243/remove-debugger 0.0.1

package/.vscodeignore

@@ -0,0 +1,9 @@
+.vscode/**
+src/**
+.gitignore
+tsconfig.json
+**/*.map
+**/*.ts
+!out/**
+node_modules/**
+docs/**

package/docs/superpowers/plans/2026-06-03-remove-debugger-extension.md

@@ -0,0 +1,319 @@
+# Remove Debugger VS Code Extension Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Build a VS Code extension that adds an editor title bar button to remove `debugger;` statements and `console.*()` calls from the active JS/TS file.
+
+**Architecture:** Single `extension.ts` file registers a command bound to an editor title bar button. When clicked, it reads the active document, applies regex patterns (controlled by user settings) to strip matching lines, then replaces the document via `WorkspaceEdit` to preserve undo history.
+
+**Tech Stack:** TypeScript, VS Code Extension API (`vscode`), Node.js built-ins only — no external runtime dependencies.
+
+---
+
+## File Map
+
+| File | Action | Responsibility |
+|---|---|---|
+| `package.json` | Create | Extension manifest: name, commands, menus, settings, activationEvents |
+| `tsconfig.json` | Create | TypeScript compiler config |
+| `.vscodeignore` | Create | Exclude dev files from packaged extension |
+| `src/extension.ts` | Create | `activate()`, command handler, removal logic |
+
+---
+
+### Task 1: Scaffold package.json
+
+**Files:**
+- Create: `package.json`
+
+- [ ] **Step 1: Create package.json**
+
+```json
+{
+  "name": "remove-debugger",
+  "displayName": "Remove Debugger",
+  "description": "Remove debugger statements and console calls from JS/TS files",
+  "version": "0.0.1",
+  "engines": { "vscode": "^1.75.0" },
+  "categories": ["Other"],
+  "activationEvents": [
+    "onLanguage:javascript",
+    "onLanguage:typescript",
+    "onLanguage:javascriptreact",
+    "onLanguage:typescriptreact"
+  ],
+  "main": "./out/extension.js",
+  "contributes": {
+    "commands": [
+      {
+        "command": "removeDebugger.clean",
+        "title": "Remove Debugger & Console",
+        "icon": "$(trash)"
+      }
+    ],
+    "menus": {
+      "editor/title": [
+        {
+          "command": "removeDebugger.clean",
+          "when": "editorLangId == javascript || editorLangId == typescript || editorLangId == javascriptreact || editorLangId == typescriptreact",
+          "group": "navigation"
+        }
+      ]
+    },
+    "configuration": {
+      "title": "Remove Debugger",
+      "properties": {
+        "removeDebugger.removeDebugger": {
+          "type": "boolean",
+          "default": true,
+          "description": "Remove debugger; statements."
+        },
+        "removeDebugger.removeConsole": {
+          "type": "boolean",
+          "default": true,
+          "description": "Remove console.* calls."
+        },
+        "removeDebugger.consoleMethodsToRemove": {
+          "type": "array",
+          "default": ["log", "warn", "error", "info", "debug", "trace"],
+          "description": "Which console methods to remove when removeConsole is enabled."
+        }
+      }
+    }
+  },
+  "scripts": {
+    "vscode:prepublish": "npm run compile",
+    "compile": "tsc -p ./",
+    "watch": "tsc -watch -p ./"
+  },
+  "devDependencies": {
+    "@types/vscode": "^1.75.0",
+    "@types/node": "^18.0.0",
+    "typescript": "^5.0.0"
+  }
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add package.json
+git commit -m "feat: add extension manifest with command, menu, and settings"
+```
+
+---
+
+### Task 2: Scaffold TypeScript config and ignore file
+
+**Files:**
+- Create: `tsconfig.json`
+- Create: `.vscodeignore`
+
+- [ ] **Step 1: Create tsconfig.json**
+
+```json
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "ES2020",
+    "outDir": "out",
+    "lib": ["ES2020"],
+    "sourceMap": true,
+    "rootDir": "src",
+    "strict": true
+  },
+  "exclude": ["node_modules", ".vscode-test"]
+}
+```
+
+- [ ] **Step 2: Create .vscodeignore**
+
+```
+.vscode/**
+src/**
+.gitignore
+tsconfig.json
+**/*.map
+**/*.ts
+!out/**
+node_modules/**
+docs/**
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add tsconfig.json .vscodeignore
+git commit -m "feat: add tsconfig and vscodeignore"
+```
+
+---
+
+### Task 3: Install dev dependencies
+
+**Files:**
+- Modify: (node_modules, package-lock.json — generated)
+
+- [ ] **Step 1: Install**
+
+```bash
+npm install
+```
+
+Expected: `node_modules/` created, `package-lock.json` generated. No errors.
+
+- [ ] **Step 2: Add .gitignore**
+
+```
+node_modules/
+out/
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add .gitignore package-lock.json
+git commit -m "chore: add gitignore and lock file"
+```
+
+---
+
+### Task 4: Implement extension.ts
+
+**Files:**
+- Create: `src/extension.ts`
+
+- [ ] **Step 1: Create src/extension.ts**
+
+```typescript
+import * as vscode from 'vscode';
+
+export function activate(context: vscode.ExtensionContext): void {
+  const disposable = vscode.commands.registerCommand('removeDebugger.clean', () => {
+    const editor = vscode.window.activeTextEditor;
+    if (!editor) {
+      return;
+    }
+
+    const config = vscode.workspace.getConfiguration('removeDebugger');
+    const shouldRemoveDebugger = config.get<boolean>('removeDebugger', true);
+    const shouldRemoveConsole = config.get<boolean>('removeConsole', true);
+    const consoleMethods = config.get<string[]>('consoleMethodsToRemove', [
+      'log', 'warn', 'error', 'info', 'debug', 'trace',
+    ]);
+
+    const text = editor.document.getText();
+    const cleaned = cleanText(text, shouldRemoveDebugger, shouldRemoveConsole, consoleMethods);
+
+    if (cleaned === text) {
+      vscode.window.showInformationMessage('No debugger statements or console calls found.');
+      return;
+    }
+
+    const edit = new vscode.WorkspaceEdit();
+    const fullRange = new vscode.Range(
+      editor.document.positionAt(0),
+      editor.document.positionAt(text.length)
+    );
+    edit.replace(editor.document.uri, fullRange, cleaned);
+    vscode.workspace.applyEdit(edit);
+  });
+
+  context.subscriptions.push(disposable);
+}
+
+export function cleanText(
+  text: string,
+  removeDebugger: boolean,
+  removeConsole: boolean,
+  consoleMethods: string[]
+): string {
+  const lines = text.split('\n');
+  const filtered = lines.filter(line => {
+    if (removeDebugger && /^\s*debugger\s*;?\s*$/.test(line)) {
+      return false;
+    }
+    if (removeConsole && consoleMethods.length > 0) {
+      const methodPattern = consoleMethods.map(m => escapeRegex(m)).join('|');
+      const consoleRegex = new RegExp(
+        `^\\s*console\\.(${methodPattern})\\s*\\(.*\\)\\s*;?\\s*$`
+      );
+      if (consoleRegex.test(line)) {
+        return false;
+      }
+    }
+    return true;
+  });
+  return filtered.join('\n');
+}
+
+function escapeRegex(s: string): string {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+export function deactivate(): void {}
+```
+
+- [ ] **Step 2: Compile**
+
+```bash
+npm run compile
+```
+
+Expected: `out/extension.js` and `out/extension.js.map` created. No TypeScript errors.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/extension.ts
+git commit -m "feat: implement removal logic and command handler"
+```
+
+---
+
+### Task 5: Manual verification
+
+- [ ] **Step 1: Open VS Code in the project folder**
+
+```bash
+code .
+```
+
+- [ ] **Step 2: Press F5** to launch the Extension Development Host (a new VS Code window with the extension loaded).
+
+- [ ] **Step 3: Create a test file** in the dev host window. Save it as `test.js` with:
+
+```javascript
+function example() {
+  console.log('hello');
+  debugger;
+  console.warn('oops');
+  const x = 1 + 1;
+  console.error('bad');
+  return x;
+}
+```
+
+- [ ] **Step 4: Verify the trash-can button** appears in the editor title bar (top-right) while `test.js` is active.
+
+- [ ] **Step 5: Click the button.** Expected result:
+
+```javascript
+function example() {
+  const x = 1 + 1;
+  return x;
+}
+```
+
+- [ ] **Step 6: Press Ctrl+Z.** Expected: original file content restored.
+
+- [ ] **Step 7: Open a `.json` file.** Verify the trash-can button does NOT appear.
+
+- [ ] **Step 8: Test settings.** Open VS Code settings (Ctrl+,), search "Remove Debugger". Set `removeConsole` to `false`. Open `test.js` again, click the button. Expected: only `debugger;` removed, `console.*` lines kept.
+
+- [ ] **Step 9: Commit**
+
+```bash
+git add -A
+git commit -m "chore: verified extension works end-to-end"
+```

package/docs/superpowers/specs/2026-06-03-remove-debugger-extension-design.md

@@ -0,0 +1,83 @@
+# Remove Debugger VS Code Extension — Design Spec
+
+**Date:** 2026-06-03
+
+## Overview
+
+A lightweight VS Code extension that removes `debugger;` statements and `console.*()` calls from the active JavaScript or TypeScript file via a single click on an editor title bar button.
+
+## Target Languages
+
+JavaScript, TypeScript, JSX, TSX (language IDs: `javascript`, `typescript`, `javascriptreact`, `typescriptreact`).
+
+## Activation
+
+The extension activates when a JS/TS file becomes the active editor. A button appears in the editor title bar (top-right) only for supported language IDs, registered via the `editor/title` contribution point in `package.json`.
+
+## Removal Logic
+
+Approach: regex-based line replacement. When the button is clicked, the extension:
+
+1. Reads the full text of the active document.
+2. Applies enabled regex patterns in sequence to remove matching lines.
+3. Replaces the document content via a `WorkspaceEdit` — this preserves undo history.
+
+**Known limitation:** Multi-line `console.*()` calls (arguments spanning multiple lines) are not removed — only the opening line is matched. This is acceptable for a dev-convenience tool.
+
+### Patterns
+
+| What | Regex (per line) |
+|---|---|
+| `debugger;` | `/^\s*debugger\s*;?\s*$/` |
+| `console.<method>(...)` | `/^\s*console\.(log\|warn\|error\|...)\s*\(.*\)\s*;?\s*$/` |
+
+Lines that are entirely consumed by the match are deleted (including the trailing newline). Lines where a `console.*` call is embedded in a larger expression (e.g., `return console.log(x)`) are left untouched.
+
+## Settings
+
+```json
+"removeDebugger.removeDebugger": {
+  "type": "boolean",
+  "default": true,
+  "description": "Remove debugger; statements."
+},
+"removeDebugger.removeConsole": {
+  "type": "boolean",
+  "default": true,
+  "description": "Remove console.* calls."
+},
+"removeDebugger.consoleMethodsToRemove": {
+  "type": "array",
+  "default": ["log", "warn", "error", "info", "debug", "trace"],
+  "description": "Which console methods to remove when removeConsole is enabled."
+}
+```
+
+Users can keep `console.error` while removing `console.log` by editing `consoleMethodsToRemove`.
+
+## Project Structure
+
+```
+remove-debugger-vs-extension/
+├── src/
+│   └── extension.ts       # activate(), command handler, removal logic
+├── package.json           # manifest: commands, menus, settings, activationEvents
+├── tsconfig.json
+└── .vscodeignore
+```
+
+All logic lives in `extension.ts`. No external runtime dependencies — only the VS Code API and Node built-ins.
+
+## Error Handling
+
+- If no active editor is open, the command is a no-op (button is hidden by `when` clause).
+- If the document is not a supported language, the button does not render.
+- If no matches are found, the document is unchanged (no empty edit applied).
+
+## Testing
+
+Manual testing only for initial version:
+- Open a JS/TS file with `debugger;` and `console.log()` lines, click the button, verify removal.
+- Verify undo (`Ctrl+Z`) restores the original content.
+- Verify settings (`removeConsole: false`) correctly skips console removal.
+- Verify button does not appear on non-JS/TS files (e.g., `.json`, `.md`).

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@user231243/remove-debugger",
+  "publisher": "user231243",
+  "publishConfig": {
+    "access": "public"
+  },
+  "displayName": "Remove Debugger",
+  "description": "Remove debugger statements and console calls from JS/TS files",
+  "version": "0.0.1",
+  "engines": { "vscode": "^1.75.0" },
+  "categories": ["Other"],
+  "activationEvents": [
+    "onLanguage:javascript",
+    "onLanguage:typescript",
+    "onLanguage:javascriptreact",
+    "onLanguage:typescriptreact"
+  ],
+  "main": "./out/extension.js",
+  "contributes": {
+    "commands": [
+      {
+        "command": "removeDebugger.clean",
+        "title": "Remove Debugger & Console",
+        "icon": "$(trash)"
+      }
+    ],
+    "menus": {
+      "editor/title": [
+        {
+          "command": "removeDebugger.clean",
+          "when": "editorLangId == javascript || editorLangId == typescript || editorLangId == javascriptreact || editorLangId == typescriptreact",
+          "group": "navigation"
+        }
+      ]
+    },
+    "configuration": {
+      "title": "Remove Debugger",
+      "properties": {
+        "removeDebugger.removeDebugger": {
+          "type": "boolean",
+          "default": true,
+          "description": "Remove debugger; statements."
+        },
+        "removeDebugger.removeConsole": {
+          "type": "boolean",
+          "default": true,
+          "description": "Remove console.* calls."
+        },
+        "removeDebugger.consoleMethodsToRemove": {
+          "type": "array",
+          "default": ["log", "warn", "error", "info", "debug", "trace"],
+          "description": "Which console methods to remove when removeConsole is enabled."
+        }
+      }
+    }
+  },
+  "scripts": {
+    "vscode:prepublish": "npm run compile",
+    "compile": "tsc -p ./",
+    "watch": "tsc -watch -p ./"
+  },
+  "devDependencies": {
+    "@types/vscode": "^1.75.0",
+    "@types/node": "^18.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/extension.ts

@@ -0,0 +1,66 @@
+import * as vscode from 'vscode';
+
+export function activate(context: vscode.ExtensionContext): void {
+  const disposable = vscode.commands.registerCommand('removeDebugger.clean', () => {
+    const editor = vscode.window.activeTextEditor;
+    if (!editor) {
+      return;
+    }
+
+    const config = vscode.workspace.getConfiguration('removeDebugger');
+    const shouldRemoveDebugger = config.get<boolean>('removeDebugger', true);
+    const shouldRemoveConsole = config.get<boolean>('removeConsole', true);
+    const consoleMethods = config.get<string[]>('consoleMethodsToRemove', [
+      'log', 'warn', 'error', 'info', 'debug', 'trace',
+    ]);
+
+    const text = editor.document.getText();
+    const cleaned = cleanText(text, shouldRemoveDebugger, shouldRemoveConsole, consoleMethods);
+
+    if (cleaned === text) {
+      vscode.window.showInformationMessage('No debugger statements or console calls found.');
+      return;
+    }
+
+    const edit = new vscode.WorkspaceEdit();
+    const fullRange = new vscode.Range(
+      editor.document.positionAt(0),
+      editor.document.positionAt(text.length)
+    );
+    edit.replace(editor.document.uri, fullRange, cleaned);
+    vscode.workspace.applyEdit(edit);
+  });
+
+  context.subscriptions.push(disposable);
+}
+
+export function cleanText(
+  text: string,
+  removeDebugger: boolean,
+  removeConsole: boolean,
+  consoleMethods: string[]
+): string {
+  const lines = text.split('\n');
+  const filtered = lines.filter(line => {
+    if (removeDebugger && /^\s*debugger\s*;?\s*$/.test(line)) {
+      return false;
+    }
+    if (removeConsole && consoleMethods.length > 0) {
+      const methodPattern = consoleMethods.map(m => escapeRegex(m)).join('|');
+      const consoleRegex = new RegExp(
+        `^\\s*console\\.(${methodPattern})\\s*\\(.*\\)\\s*;?\\s*$`
+      );
+      if (consoleRegex.test(line)) {
+        return false;
+      }
+    }
+    return true;
+  });
+  return filtered.join('\n');
+}
+
+function escapeRegex(s: string): string {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+export function deactivate(): void {}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "ES2020",
+    "outDir": "out",
+    "lib": ["ES2020"],
+    "sourceMap": true,
+    "rootDir": "src",
+    "strict": true
+  },
+  "exclude": ["node_modules", ".vscode-test"]
+}