deepflow 0.1.51 → 0.1.52

package/README.md

@@ -130,6 +130,16 @@ Execution happens in an isolated git worktree:
 - Resume with `/df:execute --continue`
 - On success, `/df:verify` merges to main and cleans up
 
+## LSP Integration
+
+deepflow automatically enables Claude Code's LSP tools during install, giving agents access to `goToDefinition`, `findReferences`, and `workspaceSymbol` for precise code navigation instead of grep-based searching.
+
+- **Global install:** sets `ENABLE_LSP_TOOL=1` in `~/.claude/settings.json`
+- **Project install:** sets it in `.claude/settings.local.json`
+- **Uninstall:** cleans up automatically
+
+Agents prefer LSP tools when available and fall back to Grep/Glob silently. You'll need a language server installed for your language (e.g. `typescript-language-server`, `pyright`, `rust-analyzer`, `gopls`).
+
 ## Context-Aware Execution
 
 Statusline shows context usage. At ≥50%:

package/bin/install.js

@@ -142,6 +142,11 @@ async function main() {
     await configureHooks(CLAUDE_DIR);
   }
 
+  // Configure project settings (project only)
+  if (level === 'project') {
+    configureProjectSettings(CLAUDE_DIR);
+  }
+
   console.log('');
   console.log(`${c.green}Installation complete!${c.reset}`);
   console.log('');
@@ -152,6 +157,7 @@ async function main() {
   if (level === 'global') {
     console.log('  hooks/           — statusline, update checker');
   }
+  console.log('  env/             — ENABLE_LSP_TOOL (code navigation via goToDefinition, findReferences, workspaceSymbol)');
   console.log('');
   if (level === 'project') {
     console.log(`${c.dim}Note: Statusline is only available with global install.${c.reset}`);
@@ -208,6 +214,11 @@ async function configureHooks(claudeDir) {
     }
   }
 
+  // Enable LSP tool
+  if (!settings.env) settings.env = {};
+  settings.env.ENABLE_LSP_TOOL = "1";
+  log('LSP tool enabled');
+
   // Configure statusline
   if (settings.statusLine) {
     const answer = await ask(
@@ -258,6 +269,27 @@ async function configureHooks(claudeDir) {
   fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
 }
 
+function configureProjectSettings(claudeDir) {
+  const settingsPath = path.join(claudeDir, 'settings.local.json');
+
+  let settings = {};
+
+  if (fs.existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+    } catch (e) {
+      settings = {};
+    }
+  }
+
+  // Enable LSP tool
+  if (!settings.env) settings.env = {};
+  settings.env.ENABLE_LSP_TOOL = "1";
+
+  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+  log('LSP tool enabled (project)');
+}
+
 function ask(question) {
   const rl = readline.createInterface({
     input: process.stdin,
@@ -383,6 +415,44 @@ async function uninstall() {
         // Fail silently
       }
     }
+
+    // Remove ENABLE_LSP_TOOL from global settings
+    if (fs.existsSync(settingsPath)) {
+      try {
+        const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+        if (settings.env?.ENABLE_LSP_TOOL) {
+          delete settings.env.ENABLE_LSP_TOOL;
+          if (settings.env && Object.keys(settings.env).length === 0) delete settings.env;
+          fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+          console.log(`  ${c.green}✓${c.reset} Removed ENABLE_LSP_TOOL from settings`);
+        }
+      } catch (e) {
+        // Fail silently
+      }
+    }
+  }
+
+  // Remove ENABLE_LSP_TOOL from project settings.local.json
+  if (level === 'project') {
+    const localSettingsPath = path.join(PROJECT_DIR, 'settings.local.json');
+    if (fs.existsSync(localSettingsPath)) {
+      try {
+        const localSettings = JSON.parse(fs.readFileSync(localSettingsPath, 'utf8'));
+        if (localSettings.env?.ENABLE_LSP_TOOL) {
+          delete localSettings.env.ENABLE_LSP_TOOL;
+          if (localSettings.env && Object.keys(localSettings.env).length === 0) delete localSettings.env;
+          if (Object.keys(localSettings).length === 0) {
+            fs.unlinkSync(localSettingsPath);
+            console.log(`  ${c.green}✓${c.reset} Removed settings.local.json (empty after cleanup)`);
+          } else {
+            fs.writeFileSync(localSettingsPath, JSON.stringify(localSettings, null, 2));
+            console.log(`  ${c.green}✓${c.reset} Removed ENABLE_LSP_TOOL from settings.local.json`);
+          }
+        }
+      } catch (e) {
+        // Fail silently
+      }
+    }
   }
 
   console.log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepflow",
-  "version": "0.1.51",
+  "version": "0.1.52",
   "description": "Stay in flow state - lightweight spec-driven task orchestration for Claude Code",
   "keywords": [
     "claude",

package/src/commands/df/execute.md

@@ -328,6 +328,9 @@ Commit format: {commit_type}({spec}): {description}
 Result file: {worktree_absolute_path}/.deepflow/results/{task_id}.yaml
 
 STOP after writing the result file. Do NOT merge branches, rename spec files, remove worktrees, or run git checkout on main. These are handled by the orchestrator and /df:verify.
+
+Navigation: Prefer LSP tools (goToDefinition, findReferences, workspaceSymbol) over Grep/Glob for code navigation. Fall back to Grep/Glob if LSP unavailable.
+If LSP errors, install the language server (TS→typescript-language-server, Python→pyright, Rust→rust-analyzer, Go→gopls) and retry. If still unavailable, use Grep/Glob.
 ```
 
 **Standard Task (append after preamble):**

package/src/commands/df/verify.md

@@ -72,6 +72,7 @@ Run the build command in the worktree:
 
 Check requirements, acceptance criteria, and quality (stubs/TODOs).
 Mark each: ✓ satisfied | ✗ missing | ⚠ partial
+Prefer LSP tools (goToDefinition, findReferences, workspaceSymbol) when available; fall back to Grep/Glob silently.
 
 **L4: Test execution** (if test command detected)
 
@@ -141,9 +142,9 @@ Files: ...
 | Level | Check | Method | Runner |
 |-------|-------|--------|--------|
 | L0: Builds | Code compiles/builds | Run build command | Orchestrator (Bash) |
-| L1: Exists | File/function exists | Glob/Grep | Explore agents |
+| L1: Exists | File/function exists | Glob/Grep (prefer workspaceSymbol if available) | Explore agents |
 | L2: Substantive | Real code, not stub | Read + analyze | Explore agents |
-| L3: Wired | Integrated into system | Trace imports/calls | Explore agents |
+| L3: Wired | Integrated into system | Trace imports/calls (prefer findReferences if available) | Explore agents |
 | L4: Tested | Tests pass | Run test command | Orchestrator (Bash) |
 
 **Default: L0 through L4.** L0 and L4 skipped ONLY if no build/test command detected (see step 1.5). L0 and L4 run via Bash — Explore agents cannot execute commands.