specweave 1.0.186 → 1.0.187

package/CLAUDE.md

@@ -1,4 +1,4 @@
-<!-- SW:META template="claude" version="1.0.184" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,structure,taskformat,secrets,syncing,testing,tdd,api,limits,troubleshooting,lazyloading,principles,linking,mcp,auto,docs" -->
+<!-- SW:META template="claude" version="1.0.186" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,structure,taskformat,secrets,syncing,testing,tdd,api,limits,troubleshooting,lazyloading,principles,linking,mcp,auto,docs" -->
 
 <!-- SW:SECTION:hook-priority version="1.0.171" -->
 ## ⛔ ABSOLUTE PRIORITY: Hook Instructions Are Mandatory
@@ -53,7 +53,7 @@ Hooks exist to enforce workflow discipline. If you ignore them:
 **This is non-negotiable. No exceptions. No "just this once".**
 <!-- SW:END:hook-priority -->
 
-<!-- SW:SECTION:header version="1.0.184" -->
+<!-- SW:SECTION:header version="1.0.186" -->
 **Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
 <!-- SW:END:header -->
 
@@ -244,7 +244,7 @@ The official `typescript-lsp@claude-plugins-official` and similar plugins:
 
 Use `boostvolt/claude-code-lsps` until official plugins are fixed.
 
-<!-- SW:SECTION:start version="1.0.184" -->
+<!-- SW:SECTION:start version="1.0.186" -->
 ## Getting Started
 
 **Initial increment**: `0001-project-setup` (auto-created by `specweave init`)
@@ -254,7 +254,7 @@ Use `boostvolt/claude-code-lsps` until official plugins are fixed.
 2. **Customize**: Edit spec.md and use for setup tasks
 <!-- SW:END:start -->
 
-<!-- SW:SECTION:autodetect version="1.0.184" -->
+<!-- SW:SECTION:autodetect version="1.0.186" -->
 ## Auto-Detection
 
 SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
@@ -264,7 +264,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Opt-out phrases**: "Just brainstorm first" | "Don't plan yet" | "Quick discussion" | "Let's explore ideas"
 <!-- SW:END:autodetect -->
 
-<!-- SW:SECTION:metarule version="1.0.184" -->
+<!-- SW:SECTION:metarule version="1.0.186" -->
 ## Meta-Rule: Think-Before-Act
 
 **Satisfy dependencies BEFORE dependent operations.**
@@ -275,7 +275,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 ```
 <!-- SW:END:metarule -->
 
-<!-- SW:SECTION:rules version="1.0.184" -->
+<!-- SW:SECTION:rules version="1.0.186" -->
 ## Rules
 
 1. **Files** → `.specweave/increments/####-name/` (see Structure section for details)
@@ -286,7 +286,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 6. **⛔ Marketplace refresh**: Use `specweave refresh-marketplace` CLI (not `scripts/refresh-marketplace.sh`)
 <!-- SW:END:rules -->
 
-<!-- SW:SECTION:workflow version="1.0.184" -->
+<!-- SW:SECTION:workflow version="1.0.186" -->
 ## Workflow
 
 `/sw:increment "X"` → `/sw:do` → `/sw:progress` → `/sw:done 0001`
@@ -306,7 +306,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Natural language**: "Let's build X" → `/sw:increment` | "What's status?" → `/sw:progress` | "We're done" → `/sw:done` | "Ship while sleeping" → `/sw:auto`
 <!-- SW:END:workflow -->
 
-<!-- SW:SECTION:reflect version="1.0.184" -->
+<!-- SW:SECTION:reflect version="1.0.186" -->
 ## Skill Memories
 
 SpecWeave learns from corrections. Learnings saved here automatically. Edit or delete as needed.
@@ -329,7 +329,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 - **2026-01-29**: in this codebase. Then use goToDefinition to show me where it's defined.
 - **2026-01-29**: ✗→✓ Find All References of handleAutoCommand using LSP The user wants me to find all references to handl
 
-<!-- SW:SECTION:context version="1.0.184" -->
+<!-- SW:SECTION:context version="1.0.186" -->
 ## Context
 
 **Before implementing**: Check ADRs at `.specweave/docs/internal/architecture/adr/`
@@ -337,7 +337,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 **Load context**: `/sw:context <topic>` loads relevant living docs into conversation
 <!-- SW:END:context -->
 
-<!-- SW:SECTION:structure version="1.0.184" -->
+<!-- SW:SECTION:structure version="1.0.186" -->
 ## Structure
 
 ```
@@ -352,7 +352,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 **Everything else → subfolders**: `reports/` | `logs/` | `scripts/` | `backups/`
 <!-- SW:END:structure -->
 
-<!-- SW:SECTION:taskformat version="1.0.184" -->
+<!-- SW:SECTION:taskformat version="1.0.186" -->
 ## Task Format
 
 ```markdown
@@ -362,7 +362,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
 ```
 <!-- SW:END:taskformat -->
 
-<!-- SW:SECTION:secrets version="1.0.184" -->
+<!-- SW:SECTION:secrets version="1.0.186" -->
 ## Secrets Check
 
 **BEFORE CLI tools**: Check existing config first!
@@ -376,7 +376,7 @@ gh auth status
 **SECURITY**: NEVER use `grep TOKEN .env` without `-q` flag - it exposes credentials in terminal!
 <!-- SW:END:secrets -->
 
-<!-- SW:SECTION:syncing version="1.0.184" -->
+<!-- SW:SECTION:syncing version="1.0.186" -->
 ## External Sync (GitHub/JIRA/ADO)
 
 **Commands**: `/sw-github:sync {id}` (issues) | `/sw:sync-specs` (living docs only)
@@ -386,7 +386,7 @@ gh auth status
 **Config**: Set `sync.github.enabled: true` + `canUpdateExternalItems: true` in config.json
 <!-- SW:END:syncing -->
 
-<!-- SW:SECTION:testing version="1.0.184" -->
+<!-- SW:SECTION:testing version="1.0.186" -->
 ## Testing
 
 BDD in tasks.md | Unit >80% | `.test.ts` (Vitest)
@@ -398,7 +398,7 @@ vi.mock('./module', () => ({ func: mockFn }));
 ```
 <!-- SW:END:testing -->
 
-<!-- SW:SECTION:tdd version="1.0.184" -->
+<!-- SW:SECTION:tdd version="1.0.186" -->
 ## TDD Mode (Test-Driven Development)
 
 **When `testing.defaultTestMode: "TDD"` is configured**, follow RED-GREEN-REFACTOR discipline:
@@ -459,7 +459,7 @@ When TDD is enabled, tasks include phase markers:
 **Rule**: Complete dependencies BEFORE dependent tasks (RED before GREEN).
 <!-- SW:END:tdd -->
 
-<!-- SW:SECTION:api version="1.0.184" -->
+<!-- SW:SECTION:api version="1.0.186" -->
 ## API Development (OpenAPI-First)
 
 **For API projects only.** Commands: `/sw:api-docs --all` | `--openapi` | `--postman` | `--validate`
@@ -467,13 +467,13 @@ When TDD is enabled, tasks include phase markers:
 Enable in config: `{"apiDocs":{"enabled":true,"openApiPath":"openapi.yaml"}}`
 <!-- SW:END:api -->
 
-<!-- SW:SECTION:limits version="1.0.184" -->
+<!-- SW:SECTION:limits version="1.0.186" -->
 ## Limits
 
 **Max 1500 lines/file** — extract before adding
 <!-- SW:END:limits -->
 
-<!-- SW:SECTION:troubleshooting version="1.0.184" -->
+<!-- SW:SECTION:troubleshooting version="1.0.186" -->
 ## Troubleshooting
 
 | Issue | Fix |
@@ -489,7 +489,7 @@ Enable in config: `{"apiDocs":{"enabled":true,"openApiPath":"openapi.yaml"}}`
 | Marketplace shows 0 | Normal with auto-load; `/plugin list` shows actual |
 <!-- SW:END:troubleshooting -->
 
-<!-- SW:SECTION:lazyloading version="1.0.184" -->
+<!-- SW:SECTION:lazyloading version="1.0.186" -->
 ## Plugin Auto-Loading
 
 Plugins load automatically based on project type and keywords. Manual install if needed:
@@ -503,7 +503,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1         # Disable auto-load
 **Token savings**: Core ~3-5K tokens vs all plugins ~60K+
 <!-- SW:END:lazyloading -->
 
-<!-- SW:SECTION:principles version="1.0.184" -->
+<!-- SW:SECTION:principles version="1.0.186" -->
 ## Principles
 
 1. **Spec-first**: `/sw:increment` before coding
@@ -512,7 +512,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1         # Disable auto-load
 4. **Traceable**: All work → specs → ACs
 <!-- SW:END:principles -->
 
-<!-- SW:SECTION:linking version="1.0.184" -->
+<!-- SW:SECTION:linking version="1.0.186" -->
 ## Bidirectional Linking
 
 Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
@@ -520,7 +520,7 @@ Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
 Task format: `**AC**: AC-US1-01, AC-US1-02` (CRITICAL for linking)
 <!-- SW:END:linking -->
 
-<!-- SW:SECTION:mcp version="1.0.184" -->
+<!-- SW:SECTION:mcp version="1.0.186" -->
 ## External Services
 
 **Priority**: CLI tools first (simpler) → MCP for complex integrations
@@ -542,7 +542,7 @@ claude mcp add --transport stdio postgres -- npx -y @modelcontextprotocol/server
 MCP supports lazy-loading (auto mode) - tools load on-demand when >10% context.
 <!-- SW:END:mcp -->
 
-<!-- SW:SECTION:auto version="1.0.184" -->
+<!-- SW:SECTION:auto version="1.0.186" -->
 ## Auto Mode
 
 **Commands**: `/sw:auto` (start) | `/sw:auto-status` (check) | `/sw:cancel-auto` (emergency only)
@@ -559,7 +559,7 @@ MCP supports lazy-loading (auto mode) - tools load on-demand when >10% context.
 **STOP & ASK** if: Spec conflicts | Task unnecessary | Requirement ambiguous
 <!-- SW:END:auto -->
 
-<!-- SW:SECTION:docs version="1.0.184" -->
+<!-- SW:SECTION:docs version="1.0.186" -->
 ## Docs
 
 [spec-weave.com](https://spec-weave.com)

package/bin/specweave.js

@@ -649,6 +649,51 @@ program
     await cacheCommand(options);
   });
 
+// LSP command - Code intelligence operations
+const lspCmd = program
+  .command('lsp')
+  .description('LSP code intelligence (refs, def, hover, symbols, search)');
+
+lspCmd
+  .command('refs <file> <symbol>')
+  .description('Find all references to a symbol')
+  .action(async (file, symbol) => {
+    const { handleLspRefs } = await import('../dist/src/cli/commands/lsp.js');
+    await handleLspRefs(process.cwd(), file, symbol);
+  });
+
+lspCmd
+  .command('def <file> <symbol>')
+  .description('Go to definition of a symbol')
+  .action(async (file, symbol) => {
+    const { handleLspDef } = await import('../dist/src/cli/commands/lsp.js');
+    await handleLspDef(process.cwd(), file, symbol);
+  });
+
+lspCmd
+  .command('hover <file> <symbol>')
+  .description('Get type information for a symbol')
+  .action(async (file, symbol) => {
+    const { handleLspHover } = await import('../dist/src/cli/commands/lsp.js');
+    await handleLspHover(process.cwd(), file, symbol);
+  });
+
+lspCmd
+  .command('symbols <file>')
+  .description('List all symbols in a file')
+  .action(async (file) => {
+    const { handleLspSymbols } = await import('../dist/src/cli/commands/lsp.js');
+    await handleLspSymbols(process.cwd(), file);
+  });
+
+lspCmd
+  .command('search <query>')
+  .description('Search for symbols in workspace')
+  .action(async (query) => {
+    const { handleLspSearch } = await import('../dist/src/cli/commands/lsp.js');
+    await handleLspSearch(process.cwd(), query);
+  });
+
 // Commits command - Display last 2 git commits
 program
   .command('commits')

package/dist/src/cli/commands/lsp.d.ts

@@ -0,0 +1,50 @@
+/**
+ * LSP CLI Commands
+ *
+ * Provides CLI interface to LSP operations: refs, def, hover, symbols, search.
+ * Accepts symbol NAME (not line:char) for ease of use.
+ *
+ * @module cli/commands/lsp
+ */
+import { Command } from 'commander';
+/**
+ * Position in a file (0-indexed)
+ */
+export interface SymbolPosition {
+    line: number;
+    character: number;
+}
+/**
+ * Find the position of a symbol in a file by name.
+ * Uses regex with word boundaries to find the symbol declaration.
+ *
+ * @param filePath - Path to the file
+ * @param symbolName - Name of the symbol to find
+ * @returns Position (0-indexed) or null if not found
+ */
+export declare function findSymbolPosition(filePath: string, symbolName: string): SymbolPosition | null;
+/**
+ * Find all references to a symbol
+ */
+export declare function handleLspRefs(projectRoot: string, filePath: string, symbolName: string): Promise<void>;
+/**
+ * Go to definition of a symbol
+ */
+export declare function handleLspDef(projectRoot: string, filePath: string, symbolName: string): Promise<void>;
+/**
+ * Get hover/type information for a symbol
+ */
+export declare function handleLspHover(projectRoot: string, filePath: string, symbolName: string): Promise<void>;
+/**
+ * List all symbols in a file
+ */
+export declare function handleLspSymbols(projectRoot: string, filePath: string): Promise<void>;
+/**
+ * Search for symbols in workspace
+ */
+export declare function handleLspSearch(projectRoot: string, query: string): Promise<void>;
+/**
+ * Create the LSP command for Commander.js
+ */
+export declare function createLspCommand(): Command;
+//# sourceMappingURL=lsp.d.ts.map

package/dist/src/cli/commands/lsp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/lsp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAiD9F;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAiCf;AA+BD;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AA+BD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B3F;AAsCD;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BvF;AAyED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAiD1C"}

package/dist/src/cli/commands/lsp.js

@@ -0,0 +1,410 @@
+/**
+ * LSP CLI Commands
+ *
+ * Provides CLI interface to LSP operations: refs, def, hover, symbols, search.
+ * Accepts symbol NAME (not line:char) for ease of use.
+ *
+ * @module cli/commands/lsp
+ */
+import fs from 'fs';
+import path from 'path';
+import { Command } from 'commander';
+import { getGlobalLSPManager, shutdownGlobalLSPManager } from '../../core/lsp/lsp-manager.js';
+/**
+ * Find the position of a symbol in a file by name.
+ * Uses regex with word boundaries to find the symbol declaration.
+ *
+ * @param filePath - Path to the file
+ * @param symbolName - Name of the symbol to find
+ * @returns Position (0-indexed) or null if not found
+ */
+export function findSymbolPosition(filePath, symbolName) {
+    const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);
+    if (!fs.existsSync(resolvedPath)) {
+        return null;
+    }
+    const content = fs.readFileSync(resolvedPath, 'utf-8');
+    const lines = content.split('\n');
+    // Patterns to match symbol declarations (in order of specificity)
+    const patterns = [
+        // Function/method declaration: function name(, async function name(, name(
+        new RegExp(`\\b(?:export\\s+)?(?:async\\s+)?function\\s+(${symbolName})\\s*\\(`),
+        // Class declaration
+        new RegExp(`\\b(?:export\\s+)?class\\s+(${symbolName})\\b`),
+        // Interface declaration
+        new RegExp(`\\b(?:export\\s+)?interface\\s+(${symbolName})\\b`),
+        // Type declaration
+        new RegExp(`\\b(?:export\\s+)?type\\s+(${symbolName})\\b`),
+        // Const/let/var declaration
+        new RegExp(`\\b(?:export\\s+)?(?:const|let|var)\\s+(${symbolName})\\b`),
+        // Method in class (indented)
+        new RegExp(`^\\s+(?:async\\s+)?(${symbolName})\\s*\\(`),
+        // Property assignment in object/class
+        new RegExp(`\\b(${symbolName})\\s*[:=]`),
+        // Generic word boundary match (fallback)
+        new RegExp(`\\b(${symbolName})\\b`),
+    ];
+    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+        const line = lines[lineIndex];
+        for (const pattern of patterns) {
+            const match = pattern.exec(line);
+            if (match) {
+                // Find the position of the captured group (the symbol name)
+                const symbolStartIndex = line.indexOf(match[1], match.index);
+                if (symbolStartIndex !== -1) {
+                    return {
+                        line: lineIndex,
+                        character: symbolStartIndex,
+                    };
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Find all references to a symbol
+ */
+export async function handleLspRefs(projectRoot, filePath, symbolName) {
+    const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);
+    // Find symbol position
+    const position = findSymbolPosition(resolvedPath, symbolName);
+    if (!position) {
+        console.error(`Symbol '${symbolName}' not found in ${filePath}`);
+        return;
+    }
+    try {
+        const lspManager = getGlobalLSPManager(projectRoot);
+        await lspManager.initialize();
+        const result = await lspManager.findReferences(resolvedPath, position.line, position.character);
+        if (result && result.success && result.locations.length > 0) {
+            console.log(`References to '${symbolName}':\n`);
+            for (const loc of result.locations) {
+                const relPath = path.relative(projectRoot, loc.uri.replace('file://', ''));
+                console.log(`  ${relPath}:${loc.range.start.line + 1}:${loc.range.start.character + 1}`);
+            }
+            console.log(`\nTotal: ${result.locations.length} references`);
+        }
+        else {
+            // Fall back to grep-based search
+            await grepFallbackRefs(projectRoot, symbolName);
+        }
+        await shutdownGlobalLSPManager();
+    }
+    catch {
+        // LSP failed, fall back to grep
+        await grepFallbackRefs(projectRoot, symbolName);
+    }
+}
+/**
+ * Grep fallback for finding references
+ */
+async function grepFallbackRefs(projectRoot, symbolName) {
+    console.log(`References to '${symbolName}' (grep fallback):\n`);
+    const { execSync } = await import('child_process');
+    try {
+        const result = execSync(`grep -rn --include="*.ts" --include="*.tsx" --include="*.js" --include="*.jsx" "\\b${symbolName}\\b" .`, { cwd: projectRoot, encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 });
+        const lines = result.trim().split('\n').filter(Boolean);
+        for (const line of lines) {
+            console.log(`  ${line}`);
+        }
+        console.log(`\nTotal: ${lines.length} matches (grep)`);
+    }
+    catch (error) {
+        const exitCode = error.status;
+        if (exitCode === 1) {
+            console.log('  No references found');
+        }
+        else {
+            console.error('Grep search failed');
+        }
+    }
+}
+/**
+ * Go to definition of a symbol
+ */
+export async function handleLspDef(projectRoot, filePath, symbolName) {
+    const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);
+    const position = findSymbolPosition(resolvedPath, symbolName);
+    if (!position) {
+        console.error(`Symbol '${symbolName}' not found in ${filePath}`);
+        return;
+    }
+    try {
+        const lspManager = getGlobalLSPManager(projectRoot);
+        await lspManager.initialize();
+        const result = await lspManager.goToDefinition(resolvedPath, position.line, position.character);
+        if (result && result.success && result.location) {
+            const loc = result.location;
+            const relPath = path.relative(projectRoot, loc.uri.replace('file://', ''));
+            console.log(`Definition of '${symbolName}':\n`);
+            console.log(`  ${relPath}:${loc.range.start.line + 1}:${loc.range.start.character + 1}`);
+        }
+        else {
+            // Symbol is likely defined at the position we found
+            const relPath = path.relative(projectRoot, resolvedPath);
+            console.log(`Definition of '${symbolName}':\n`);
+            console.log(`  ${relPath}:${position.line + 1}:${position.character + 1}`);
+        }
+        await shutdownGlobalLSPManager();
+    }
+    catch {
+        // Fall back to showing found position
+        const relPath = path.relative(projectRoot, resolvedPath);
+        console.log(`Definition of '${symbolName}' (fallback):\n`);
+        console.log(`  ${relPath}:${position.line + 1}:${position.character + 1}`);
+    }
+}
+/**
+ * Get hover/type information for a symbol
+ */
+export async function handleLspHover(projectRoot, filePath, symbolName) {
+    const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);
+    const position = findSymbolPosition(resolvedPath, symbolName);
+    if (!position) {
+        console.error(`Symbol '${symbolName}' not found in ${filePath}`);
+        return;
+    }
+    try {
+        const lspManager = getGlobalLSPManager(projectRoot);
+        await lspManager.initialize();
+        const result = await lspManager.hover(resolvedPath, position.line, position.character);
+        if (result && result.success && result.contents) {
+            console.log(`Type info for '${symbolName}':\n`);
+            console.log(result.contents);
+        }
+        else {
+            // Fall back to showing the line content
+            await hoverFallback(resolvedPath, symbolName, position);
+        }
+        await shutdownGlobalLSPManager();
+    }
+    catch {
+        await hoverFallback(resolvedPath, symbolName, position);
+    }
+}
+/**
+ * Fallback hover showing line content
+ */
+async function hoverFallback(filePath, symbolName, position) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    const line = lines[position.line];
+    console.log(`Type info for '${symbolName}' (from source):\n`);
+    console.log(`  ${line.trim()}`);
+    // Try to infer type from declaration
+    if (line.includes('function')) {
+        console.log(`\n  Kind: function`);
+    }
+    else if (line.includes('class')) {
+        console.log(`\n  Kind: class`);
+    }
+    else if (line.includes('interface')) {
+        console.log(`\n  Kind: interface`);
+    }
+    else if (line.includes('type')) {
+        console.log(`\n  Kind: type alias`);
+    }
+    else if (line.includes('const') || line.includes('let') || line.includes('var')) {
+        console.log(`\n  Kind: variable`);
+    }
+}
+/**
+ * List all symbols in a file
+ */
+export async function handleLspSymbols(projectRoot, filePath) {
+    const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);
+    if (!fs.existsSync(resolvedPath)) {
+        console.error(`File not found: ${filePath}`);
+        return;
+    }
+    try {
+        const lspManager = getGlobalLSPManager(projectRoot);
+        await lspManager.initialize();
+        const result = await lspManager.documentSymbols(resolvedPath);
+        if (result && result.success && result.symbols.length > 0) {
+            console.log(`Symbols in ${path.basename(filePath)}:\n`);
+            for (const sym of result.symbols) {
+                const kind = getSymbolKindName(sym.kind);
+                const line = sym.location?.range?.start?.line ?? 0;
+                console.log(`  ${kind.padEnd(12)} ${sym.name} (line ${line + 1})`);
+            }
+            console.log(`\nTotal: ${result.symbols.length} symbols`);
+        }
+        else {
+            await symbolsFallback(resolvedPath);
+        }
+        await shutdownGlobalLSPManager();
+    }
+    catch {
+        await symbolsFallback(resolvedPath);
+    }
+}
+/**
+ * Fallback symbol extraction using regex
+ */
+async function symbolsFallback(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    console.log(`Symbols in ${path.basename(filePath)} (regex fallback):\n`);
+    const symbols = [];
+    const patterns = [
+        { kind: 'function', regex: /(?:export\s+)?(?:async\s+)?function\s+(\w+)/ },
+        { kind: 'class', regex: /(?:export\s+)?class\s+(\w+)/ },
+        { kind: 'interface', regex: /(?:export\s+)?interface\s+(\w+)/ },
+        { kind: 'type', regex: /(?:export\s+)?type\s+(\w+)/ },
+        { kind: 'const', regex: /(?:export\s+)?const\s+(\w+)\s*[:=]/ },
+    ];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        for (const { kind, regex } of patterns) {
+            const match = regex.exec(line);
+            if (match) {
+                symbols.push({ kind, name: match[1], line: i + 1 });
+            }
+        }
+    }
+    for (const sym of symbols) {
+        console.log(`  ${sym.kind.padEnd(12)} ${sym.name} (line ${sym.line})`);
+    }
+    console.log(`\nTotal: ${symbols.length} symbols`);
+}
+/**
+ * Search for symbols in workspace
+ */
+export async function handleLspSearch(projectRoot, query) {
+    try {
+        const lspManager = getGlobalLSPManager(projectRoot);
+        await lspManager.initialize();
+        const result = await lspManager.workspaceSymbols(query);
+        if (result && result.success && result.symbols.length > 0) {
+            console.log(`Workspace symbols matching '${query}':\n`);
+            for (const sym of result.symbols) {
+                const kind = getSymbolKindName(sym.kind);
+                const relPath = sym.location?.uri
+                    ? path.relative(projectRoot, sym.location.uri.replace('file://', ''))
+                    : 'unknown';
+                const line = sym.location?.range?.start?.line ?? 0;
+                console.log(`  ${kind.padEnd(12)} ${sym.name} (${relPath}:${line + 1})`);
+            }
+            console.log(`\nTotal: ${result.symbols.length} symbols`);
+        }
+        else {
+            await searchFallback(projectRoot, query);
+        }
+        await shutdownGlobalLSPManager();
+    }
+    catch {
+        await searchFallback(projectRoot, query);
+    }
+}
+/**
+ * Fallback workspace search using grep
+ */
+async function searchFallback(projectRoot, query) {
+    console.log(`Workspace symbols matching '${query}' (grep fallback):\n`);
+    const { execSync } = await import('child_process');
+    try {
+        // Search for declarations matching the query
+        const patterns = [
+            `function\\s+\\w*${query}\\w*`,
+            `class\\s+\\w*${query}\\w*`,
+            `interface\\s+\\w*${query}\\w*`,
+            `type\\s+\\w*${query}\\w*`,
+        ];
+        const combinedPattern = patterns.join('|');
+        const result = execSync(`grep -rn --include="*.ts" --include="*.tsx" -E "${combinedPattern}" .`, { cwd: projectRoot, encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 });
+        const lines = result.trim().split('\n').filter(Boolean);
+        for (const line of lines.slice(0, 20)) {
+            // Limit to 20 results
+            console.log(`  ${line}`);
+        }
+        if (lines.length > 20) {
+            console.log(`  ... and ${lines.length - 20} more`);
+        }
+        console.log(`\nTotal: ${lines.length} matches`);
+    }
+    catch (error) {
+        const exitCode = error.status;
+        if (exitCode === 1) {
+            console.log('  No symbols found matching query');
+        }
+        else {
+            console.error('Search failed');
+        }
+    }
+}
+/**
+ * Convert LSP symbol kind number to name
+ */
+function getSymbolKindName(kind) {
+    const kinds = {
+        1: 'File',
+        2: 'Module',
+        3: 'Namespace',
+        4: 'Package',
+        5: 'Class',
+        6: 'Method',
+        7: 'Property',
+        8: 'Field',
+        9: 'Constructor',
+        10: 'Enum',
+        11: 'Interface',
+        12: 'Function',
+        13: 'Variable',
+        14: 'Constant',
+        15: 'String',
+        16: 'Number',
+        17: 'Boolean',
+        18: 'Array',
+    };
+    return kinds[kind] || 'Unknown';
+}
+/**
+ * Create the LSP command for Commander.js
+ */
+export function createLspCommand() {
+    const lsp = new Command('lsp').description('LSP code intelligence operations');
+    // specweave lsp refs <file> <symbol>
+    lsp
+        .command('refs <file> <symbol>')
+        .description('Find all references to a symbol')
+        .action(async (file, symbol) => {
+        const projectRoot = process.cwd();
+        await handleLspRefs(projectRoot, file, symbol);
+    });
+    // specweave lsp def <file> <symbol>
+    lsp
+        .command('def <file> <symbol>')
+        .description('Go to definition of a symbol')
+        .action(async (file, symbol) => {
+        const projectRoot = process.cwd();
+        await handleLspDef(projectRoot, file, symbol);
+    });
+    // specweave lsp hover <file> <symbol>
+    lsp
+        .command('hover <file> <symbol>')
+        .description('Get type information for a symbol')
+        .action(async (file, symbol) => {
+        const projectRoot = process.cwd();
+        await handleLspHover(projectRoot, file, symbol);
+    });
+    // specweave lsp symbols <file>
+    lsp
+        .command('symbols <file>')
+        .description('List all symbols in a file')
+        .action(async (file) => {
+        const projectRoot = process.cwd();
+        await handleLspSymbols(projectRoot, file);
+    });
+    // specweave lsp search <query>
+    lsp
+        .command('search <query>')
+        .description('Search for symbols in workspace')
+        .action(async (query) => {
+        const projectRoot = process.cwd();
+        await handleLspSearch(projectRoot, query);
+    });
+    return lsp;
+}
+//# sourceMappingURL=lsp.js.map

package/dist/src/cli/commands/lsp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.js","sourceRoot":"","sources":["../../../../src/cli/commands/lsp.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.186",
+  "version": "1.0.187",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/skills/lsp/SKILL.md

@@ -1,180 +1,141 @@
 ---
 name: lsp
-description: Direct LSP (Language Server Protocol) code intelligence for any language. Use for findReferences, goToDefinition, hover, and symbol search. Works with TypeScript, Python, C#, Go, Rust. Bypasses Claude Code's built-in LSP (which has known bugs).
+description: >
+  Code intelligence via LSP - find references, go to definition, hover type info, list symbols.
+  Activates on: "find all references", "go to definition", "where is X defined",
+  "show type of", "list symbols", "search symbols", "what uses", "who calls".
+  Works with TypeScript, Python, C#, Go, Rust. Falls back to grep if LSP unavailable.
 ---
 
-# SpecWeave LSP Skill
+# LSP Code Intelligence
 
-Direct access to Language Server Protocol features for code intelligence.
+Use SpecWeave's LSP CLI for semantic code navigation and analysis.
 
-## When to Use This Skill
+## How to Use (IMPORTANT)
 
-Use this skill when the user asks for:
-- "Find all references to X"
-- "Go to definition of X"
-- "Where is X defined?"
-- "Show me the type of X"
-- "List symbols in file X"
-- "Search for symbol X in workspace"
+**Use Bash tool with `specweave lsp` commands:**
 
-## Implementation
+```bash
+# Find all references to a symbol
+specweave lsp refs <file> <symbol>
+
+# Go to definition
+specweave lsp def <file> <symbol>
+
+# Get type information (hover)
+specweave lsp hover <file> <symbol>
 
-This skill uses the existing SpecWeave LSP infrastructure:
-- `src/core/lsp/lsp-client.ts` - Low-level JSON-RPC client
-- `src/core/lsp/lsp-manager.ts` - Multi-language manager
+# List all symbols in a file
+specweave lsp symbols <file>
+
+# Search workspace for symbols
+specweave lsp search <query>
+```
 
-### Usage Pattern
+## Command Reference
 
-```typescript
-import { getGlobalLSPManager, shutdownGlobalLSPManager } from 'src/core/lsp/lsp-manager.js';
+| Command | Purpose | Example |
+|---------|---------|---------|
+| `lsp refs` | Find all usages of a symbol | `specweave lsp refs src/api.ts handleRequest` |
+| `lsp def` | Navigate to symbol definition | `specweave lsp def src/utils.ts formatDate` |
+| `lsp hover` | Get type signature and docs | `specweave lsp hover src/models.ts User` |
+| `lsp symbols` | List all symbols in file | `specweave lsp symbols src/index.ts` |
+| `lsp search` | Find symbols across workspace | `specweave lsp search Controller` |
 
-// Get the LSP manager (auto-initializes)
-const lspManager = getGlobalLSPManager(projectRoot);
+## When to Use LSP vs Grep
 
-// Find references
-const refs = await lspManager.findReferences('src/file.ts', line, character);
+| Task | Use LSP | Use Grep |
+|------|---------|----------|
+| Find function usages | ✅ `lsp refs` | ❌ |
+| Navigate to definition | ✅ `lsp def` | ❌ |
+| Get type information | ✅ `lsp hover` | ❌ |
+| Search text patterns | ❌ | ✅ `Grep tool` |
+| Find in comments | ❌ | ✅ `Grep tool` |
+| Case-insensitive search | ❌ | ✅ `Grep -i` |
 
-// Go to definition
-const def = await lspManager.goToDefinition('src/file.ts', line, character);
+**Rule of thumb**: Use LSP for symbols, Grep for text patterns.
 
-// Get hover info (types, docs)
-const hover = await lspManager.hover('src/file.ts', line, character);
+## Examples
 
-// List symbols in file
-const symbols = await lspManager.documentSymbols('src/file.ts');
+### Example 1: Find All References Before Refactoring
 
-// Search workspace for symbol
-const wsSymbols = await lspManager.workspaceSymbols('MyClass');
+User: "Find all references to handleAutoCommand"
 
-// Cleanup when done
-await shutdownGlobalLSPManager();
+```bash
+specweave lsp refs src/cli/commands/auto.ts handleAutoCommand
 ```
 
-## Supported Languages
+Output:
+```
+References to 'handleAutoCommand':
 
-| Language | Server | Detection |
-|----------|--------|-----------|
-| TypeScript/JavaScript | `typescript-language-server` | `tsconfig.json`, `package.json` |
-| Python | `pyright-langserver` or `pylsp` | `requirements.txt`, `pyproject.toml` |
-| C#/.NET | `csharp-ls` | `*.csproj`, `*.sln` |
-| Go | `gopls` | `go.mod` |
-| Rust | `rust-analyzer` | `Cargo.toml` |
+  bin/specweave.js:473:1
+  bin/specweave.js:474:1
+  src/cli/commands/auto.ts:82:5
+  src/cli/commands/auto.ts:96:24
 
-## Position Calculation
-
-LSP positions are 0-indexed:
-- `line`: 0-based line number (first line = 0)
-- `character`: 0-based character offset
-
-To find a symbol position:
-1. Read the file
-2. Count lines (0-indexed)
-3. Find character offset within the line (0-indexed)
-
-## Response Formats
-
-### findReferences
-
-```typescript
-{
-  locations: [
-    {
-      uri: 'file:///path/to/file.ts',
-      range: {
-        start: { line: 10, character: 5 },
-        end: { line: 10, character: 15 }
-      }
-    }
-  ],
-  success: true
-}
+Total: 4 references
 ```
 
-### goToDefinition
-
-```typescript
-{
-  location: {
-    uri: 'file:///path/to/definition.ts',
-    range: {
-      start: { line: 5, character: 0 },
-      end: { line: 5, character: 20 }
-    }
-  },
-  success: true
-}
+### Example 2: Go to Definition
+
+User: "Where is processArgs defined?"
+
+```bash
+specweave lsp def src/cli/commands/auto.ts processArgs
 ```
 
-### hover
+### Example 3: Get Type Information
+
+User: "What's the type signature of handleAutoCommand?"
 
-```typescript
-{
-  contents: '(method) MyClass.myMethod(): void',
-  range: { start: {...}, end: {...} },
-  success: true
-}
+```bash
+specweave lsp hover src/cli/commands/auto.ts handleAutoCommand
 ```
 
-### documentSymbols
-
-```typescript
-{
-  symbols: [
-    {
-      name: 'MyClass',
-      kind: 5, // Class
-      location: {...},
-      containerName: undefined
-    },
-    {
-      name: 'myMethod',
-      kind: 6, // Method
-      location: {...},
-      containerName: 'MyClass'
-    }
-  ],
-  success: true
-}
+### Example 4: List All Exports
+
+User: "What functions are exported from lsp.ts?"
+
+```bash
+specweave lsp symbols src/cli/commands/lsp.ts
 ```
 
-## Symbol Kinds
-
-| Kind | Name |
-|------|------|
-| 1 | File |
-| 2 | Module |
-| 3 | Namespace |
-| 4 | Package |
-| 5 | Class |
-| 6 | Method |
-| 7 | Property |
-| 8 | Field |
-| 9 | Constructor |
-| 10 | Enum |
-| 11 | Interface |
-| 12 | Function |
-| 13 | Variable |
-| 14 | Constant |
-| 15 | String |
-| 16 | Number |
-| 17 | Boolean |
-| 18 | Array |
+### Example 5: Search Workspace
+
+User: "Find all Command classes"
+
+```bash
+specweave lsp search Command
+```
+
+## Supported Languages
+
+| Language | Server Required | Auto-detected by |
+|----------|-----------------|------------------|
+| TypeScript/JS | `typescript-language-server` | `tsconfig.json`, `package.json` |
+| Python | `pyright` or `pylsp` | `requirements.txt`, `pyproject.toml` |
+| C#/.NET | `csharp-ls` | `*.csproj`, `*.sln` |
+| Go | `gopls` | `go.mod` |
+| Rust | `rust-analyzer` | `Cargo.toml` |
+
+## Fallback Behavior
+
+If LSP is unavailable (server not installed, timeout, etc.):
+1. Commands automatically fall back to grep-based search
+2. Results show "(grep fallback)" in output
+3. Still functional, but less precise for symbol resolution
 
 ## Requirements
 
 Language servers must be installed globally:
 
 ```bash
-# TypeScript
+# TypeScript (most common)
 npm install -g typescript-language-server typescript
 
 # Python
 pip install pyright
-# or
-pip install python-lsp-server
-
-# C#
-dotnet tool install -g csharp-ls
 
 # Go
 go install golang.org/x/tools/gopls@latest
@@ -183,23 +144,32 @@ go install golang.org/x/tools/gopls@latest
 rustup component add rust-analyzer
 ```
 
-## Fallback Behavior
-
-If LSP is not available for a file type:
-1. The manager returns `null`
-2. Fall back to grep-based search
-3. Results are less precise but still useful
+## Decision Tree for Claude
 
-## Example: Find All References
-
-User: "Find all references to handleAutoCommand in src/cli/commands/auto.ts"
-
-Steps:
-1. Identify file: `src/cli/commands/auto.ts`
-2. Find symbol position (read file, locate `handleAutoCommand`)
-3. Call `lspManager.findReferences('src/cli/commands/auto.ts', line, char)`
-4. Format and display results
+```
+User asks about code navigation?
+│
+├─ "Find references to X" or "What uses X" or "Who calls X"
+│   └─ Use: specweave lsp refs <file> <symbol>
+│
+├─ "Go to definition" or "Where is X defined"
+│   └─ Use: specweave lsp def <file> <symbol>
+│
+├─ "What type is X" or "Show signature of X"
+│   └─ Use: specweave lsp hover <file> <symbol>
+│
+├─ "List symbols in file" or "What's exported"
+│   └─ Use: specweave lsp symbols <file>
+│
+├─ "Find symbol X in workspace" or "Search for X"
+│   └─ Use: specweave lsp search <query>
+│
+└─ Text search, patterns, comments
+    └─ Use: Grep tool (not LSP)
+```
 
-## Why This Skill Exists
+## Why This Exists
 
-Claude Code's built-in LSP has known bugs (GitHub Issues #15148, #16291, #20050). This skill provides direct access to language servers via JSON-RPC, bypassing Claude Code's broken infrastructure.
+Claude Code's built-in LSP has known bugs (GitHub Issues #15148, #16291, #20050).
+This skill provides direct access to language servers via SpecWeave's CLI,
+bypassing the broken infrastructure.