pybao-cli 1.5.45 → 1.5.47

package/dist/{chunk-SD2KLYSK.js → chunk-J3TM7T3W.js}

@@ -2,17 +2,17 @@ import { createRequire as __pybCreateRequire } from "node:module";
 const require = __pybCreateRequire(import.meta.url);
 import {
   loadPybAgentSessionMessages
-} from "./chunk-FSHVF7L6.js";
+} from "./chunk-TLMCXAET.js";
 import {
   appendSessionCustomTitleRecord,
   appendSessionJsonlFromMessage,
   appendSessionTagRecord,
   listPybAgentSessions
-} from "./chunk-B4DLSHE7.js";
+} from "./chunk-T6S6TXIY.js";
 import {
   formatValidationResult,
   validatePluginOrMarketplacePath
-} from "./chunk-HPEY66LP.js";
+} from "./chunk-IAIXAB4N.js";
 import {
   ConversationTracker,
   appendFinishState,
@@ -20,10 +20,10 @@ import {
   getConversationTrackerForContext,
   isFinishComplete,
   mapFinishReason
-} from "./chunk-7XHORF4S.js";
+} from "./chunk-ITD4GQ6O.js";
 import {
   FileSystemConversationPersistence
-} from "./chunk-VHDLVHEI.js";
+} from "./chunk-V6W537PO.js";
 import {
   beginReplSessionScope
 } from "./chunk-F4AXICO7.js";
@@ -38,7 +38,7 @@ import {
   runStopHooks,
   runUserPromptSubmitHooks,
   updateHookTranscriptForMessages
-} from "./chunk-6TJCSOV3.js";
+} from "./chunk-6JVCLWCU.js";
 import {
   DEFAULT_OUTPUT_STYLE,
   getAvailableOutputStyles,
@@ -47,11 +47,11 @@ import {
   getOutputStyleSystemPromptAdditions,
   resolveOutputStyleName,
   setCurrentOutputStyle
-} from "./chunk-FGYA5FY5.js";
+} from "./chunk-57BVHCH3.js";
 import {
   fetchCustomModels,
   getModelFeatures
-} from "./chunk-PZ3WTDXV.js";
+} from "./chunk-Q4WANADY.js";
 import {
   getCurrentSessionId,
   getSessionState
@@ -60,7 +60,7 @@ import {
   queryLLM,
   queryQuick,
   verifyApiKey
-} from "./chunk-HPLKXHZG.js";
+} from "./chunk-ZLNJ6XFU.js";
 import {
   DEFAULT_TIMEOUT_MS,
   FallbackToolUseRejectedMessage,
@@ -75,7 +75,7 @@ import {
   listMCPServers,
   loadMergedSettings,
   normalizeSandboxRuntimeConfigFromSettings
-} from "./chunk-FS2I7CEG.js";
+} from "./chunk-SD3VNTAR.js";
 import {
   addMarketplace,
   disableSkillPlugin,
@@ -88,11 +88,11 @@ import {
   refreshMarketplaceAsync,
   removeMarketplace,
   uninstallSkillPlugin
-} from "./chunk-ILSNA4QO.js";
+} from "./chunk-GHNPBDR6.js";
 import {
   loadToolPermissionContextFromDisk,
   persistToolPermissionUpdateToDisk
-} from "./chunk-K4GZU7WR.js";
+} from "./chunk-Q2FTNJHH.js";
 import {
   applyToolPermissionContextUpdate,
   applyToolPermissionContextUpdates,
@@ -103,14 +103,14 @@ import {
   generateSystemReminders,
   resetReminderSession,
   systemReminderService
-} from "./chunk-SRWWGIOO.js";
+} from "./chunk-RRLBQ3XD.js";
 import {
   clearAgentCache,
   getActiveAgents,
   getAgentByType,
   getAllAgents,
   getAvailableAgentTypes
-} from "./chunk-QYZADXNT.js";
+} from "./chunk-A5O2MBVW.js";
 import {
   API_ERROR_MESSAGE_PREFIX,
   CANCEL_MESSAGE,
@@ -145,7 +145,7 @@ import {
   reorderMessages,
   resetAutoCompactTelemetry,
   stripSystemMessages
-} from "./chunk-RHUSN5MT.js";
+} from "./chunk-UUTMXSER.js";
 import {
   getRequestStatus,
   setRequestStatus,
@@ -177,17 +177,13 @@ import {
   normalizeFilePath,
   readTextContent,
   writeTextContent
-} from "./chunk-LO7D5L6Q.js";
+} from "./chunk-US6EALFL.js";
 import {
   parseBlockEdits
 } from "./chunk-QWIBSCDN.js";
 import {
   toLspToolFallbackEvent
 } from "./chunk-2RXKUCFS.js";
-import {
-  emitTelemetryEvent,
-  registerTelemetryListener
-} from "./chunk-TFHFYID3.js";
 import {
   LspAPI,
   LspFacade,
@@ -195,18 +191,22 @@ import {
   formatDiagnosticsPretty,
   initParser,
   loadLanguage
-} from "./chunk-A3E3KOP5.js";
+} from "./chunk-VDLMXEHU.js";
+import {
+  emitTelemetryEvent,
+  registerTelemetryListener
+} from "./chunk-TFHFYID3.js";
 import {
   getSettingsFileCandidates,
   loadSettingsWithLegacyFallback,
   readSettingsFile
-} from "./chunk-BIRC5MFX.js";
+} from "./chunk-7WPBMV6W.js";
 import {
   getCustomCommandDirectories,
   hasCustomCommands,
   loadCustomCommands,
   reloadCustomCommands
-} from "./chunk-LFTLSBFK.js";
+} from "./chunk-XIAHHC4E.js";
 import {
   getSessionPlugins
 } from "./chunk-BJSWTHRM.js";
@@ -215,7 +215,7 @@ import {
   buildModelProfileKey,
   getModelManager,
   isDefaultSlowAndCapableModel
-} from "./chunk-FZDJSTSK.js";
+} from "./chunk-K3AQYDRJ.js";
 import {
   getCodeStyle,
   getContext,
@@ -223,16 +223,16 @@ import {
   getIsGit,
   getProjectDocs,
   getProjectStructureStatisticsBlock
-} from "./chunk-G57Q2LMI.js";
+} from "./chunk-OPEQBEHZ.js";
 import {
   getRipgrepPath,
   getRipgrepPolicyMode,
   resolveRipgrepPolicy,
   ripGrep
-} from "./chunk-3V35SGQ7.js";
+} from "./chunk-7UF7PBUR.js";
 import {
   getTheme
-} from "./chunk-7BDU4UKY.js";
+} from "./chunk-N2W52I56.js";
 import {
   DEFAULT_GLOBAL_CONFIG,
   enableConfigs,
@@ -245,7 +245,7 @@ import {
   saveGlobalConfig,
   setAllPointersToModel,
   setModelPointer
-} from "./chunk-F6A7OSLF.js";
+} from "./chunk-2AU4PKSQ.js";
 import {
   AbortError
 } from "./chunk-RQVLBMP7.js";
@@ -254,7 +254,7 @@ import {
   getCurrentRequest,
   logUserFriendly,
   markPhase
-} from "./chunk-ZJJR2GKA.js";
+} from "./chunk-MWL7Q5HG.js";
 import {
   ASCII_LOGO,
   BunShell,
@@ -298,10 +298,10 @@ import {
   setCwd,
   shouldApplyToolOutputTruncation,
   truncateToolOutput
-} from "./chunk-HFEWWAXY.js";
+} from "./chunk-CN443EB5.js";
 import {
   MACRO
-} from "./chunk-T2V55G3O.js";
+} from "./chunk-5OJHTSFR.js";
 import {
   __export
 } from "./chunk-I3J4JYES.js";
@@ -482,7 +482,7 @@ var getCommandSubcommandPrefix = memoize(
 var getCommandPrefix = memoize(
   async (command4, abortSignal) => {
     const { systemPrompt, userPrompt } = buildBashCommandPrefixDetectionPrompt(command4);
-    const { API_ERROR_MESSAGE_PREFIX: API_ERROR_MESSAGE_PREFIX2, queryQuick: queryQuick2 } = await import("./llm-OTA3UYTD.js");
+    const { API_ERROR_MESSAGE_PREFIX: API_ERROR_MESSAGE_PREFIX2, queryQuick: queryQuick2 } = await import("./llm-QPAHJ643.js");
     const response = await queryQuick2({
       systemPrompt,
       userPrompt,
@@ -4284,7 +4284,7 @@ function formatParseError(error) {
   return error instanceof Error ? error.message : String(error);
 }
 async function defaultGateQuery(args) {
-  const { API_ERROR_MESSAGE_PREFIX: API_ERROR_MESSAGE_PREFIX2, queryLLM: queryLLM2 } = await import("./llm-OTA3UYTD.js");
+  const { API_ERROR_MESSAGE_PREFIX: API_ERROR_MESSAGE_PREFIX2, queryLLM: queryLLM2 } = await import("./llm-QPAHJ643.js");
   const queryLLMFn = args.queryLLMOverride ?? queryLLM2;
   const messages = [
     {
@@ -6475,12 +6475,49 @@ Usage:
 7. **Conditional Edit**: Use \`if_not_contains\` to skip the edit if the file already contains a specific string.
 8. **Thinking**: You can include "thinking" text between blocks; the tool will ignore it.
 
+## LSP-Integrated Behavior
+- **Semantic Anchor Assist**: Before fuzzy replacement, Edit tries LSP anchor matching to narrow replacement to the most relevant symbol range.
+- **When It Helps**: Especially useful when the same snippet appears multiple times and plain text matching may hit the wrong block.
+- **Fallback**: If LSP anchor is unavailable, Edit falls back to normal SEARCH/REPLACE matching.
+- **Post-Edit Verification**: Set \`verify: true\` to run LSP diagnostics after applying edits.
+- **Verification Guardrail**: If syntax/type diagnostics contain errors after edit, Edit reverts changes and returns a verification failure.
+- **When LSP Is Unavailable**: You may receive verification unavailable; retry with \`verify: false\` only when you have high confidence in edit safety.
+
 Notes:
 - The edit will FAIL if the SEARCH block matches multiple locations(ambiguous). Provide more context.
 - To delete code, leave the REPLACE section empty.
 - To create a new file, use an empty SEARCH block with the desired content in REPLACE.
 - ALWAYS prefer editing existing files. NEVER write new files unless explicitly required.
 - For Jupyter Notebooks (.ipynb), use the NotebookEditTool instead.
+
+## Typical Usage Examples
+### Example 1: Ambiguous Duplicate Snippet with LSP Anchor
+<example>
+user: Update the constructor guard in UserService, not the test helper copy
+assistant: [uses Read on UserService file to confirm target block]
+[uses Edit with SEARCH/REPLACE block and verify=true]
+[relies on LSP anchor assist to prefer semantic symbol region when duplicate text exists]
+<reasoning>
+The assistant enabled semantic-safe editing because:
+1. Duplicate snippets can cause ambiguous fuzzy matches
+2. LSP anchor narrows replacement to the intended symbol scope
+3. verify=true adds post-edit diagnostics guardrail and auto-revert on syntax errors
+</reasoning>
+</example>
+
+### Example 2: Verification-Unavailable Recovery
+<example>
+user: Apply this quick rename in a generated file
+assistant: [uses Read to confirm exact path and block]
+[uses Edit with verify=true]
+[if response says verification unavailable, retries with verify=false and tighter SEARCH context]
+<reasoning>
+The assistant keeps verification first, then degrades safely because:
+1. LSP verification is preferred for correctness
+2. Generated or unsupported files may not have active LSP diagnostics
+3. Retrying with verify=false is acceptable only after narrowing context
+</reasoning>
+</example>
 `.trim();
 
 // src/utils/terminal/paste.ts
@@ -6544,6 +6581,139 @@ function getPatch({
   }));
 }
 
+// src/tools/utils/lspFallbackHandler.ts
+function inferQuality(source) {
+  if (source === "lsp" || source === "hybrid") return "full";
+  if (source === "tree-sitter") return "partial";
+  return "minimal";
+}
+function inferConfidence(source) {
+  if (source === "lsp" || source === "hybrid" || source === "tree-sitter") return "high";
+  if (source === "token-scan") return "low";
+  return "low";
+}
+function inferSourceFromFormatted(formatted) {
+  const text = String(formatted ?? "").toLowerCase();
+  if (text.includes("no lsp server available") || text.includes("unable to initialize lsp")) {
+    return "none";
+  }
+  if (text.includes("token scan")) return "token-scan";
+  if (text.includes("tree-sitter")) return "tree-sitter";
+  return "lsp";
+}
+function inferReason(input) {
+  if (input.fallbackReason) return input.fallbackReason;
+  const text = String(input.formatted ?? "").toLowerCase();
+  if (text.includes("no lsp server available") || text.includes("unable to initialize lsp")) {
+    return "lsp-unavailable";
+  }
+  return "unknown";
+}
+function normalizeLspFallbackEvidence(input) {
+  const source = input.source ?? inferSourceFromFormatted(input.formatted);
+  const quality = input.quality ?? inferQuality(source);
+  const confidence = input.confidence ?? inferConfidence(source);
+  return {
+    source,
+    quality,
+    confidence,
+    reason: inferReason(input),
+    suggestion: input.fallbackSuggestion
+  };
+}
+function buildMessage(action, severity, evidence) {
+  return `lspFallbackHandler action=${action} severity=${severity} source=${evidence.source} quality=${evidence.quality} confidence=${evidence.confidence} reason=${evidence.reason}`;
+}
+function decideLspFallbackAction(input) {
+  const { risk, evidence, verifyMode = false, allowForce = false } = input;
+  if (risk === "high") {
+    if (evidence.source === "none") {
+      return {
+        action: "block",
+        severity: "strong",
+        message: buildMessage("block", "strong", evidence),
+        evidence
+      };
+    }
+    if (verifyMode && evidence.quality === "minimal") {
+      return {
+        action: "block",
+        severity: "strong",
+        message: buildMessage("block", "strong", evidence),
+        evidence
+      };
+    }
+    if (evidence.source === "token-scan" && evidence.quality === "minimal") {
+      if (!allowForce) {
+        return {
+          action: "block",
+          severity: "strong",
+          message: buildMessage("block", "strong", evidence),
+          evidence
+        };
+      }
+      return {
+        action: "warn",
+        severity: "strong",
+        message: buildMessage("warn", "strong", evidence),
+        evidence
+      };
+    }
+    if (evidence.source === "tree-sitter" && evidence.quality === "partial") {
+      return {
+        action: "warn",
+        severity: "normal",
+        message: buildMessage("warn", "normal", evidence),
+        evidence
+      };
+    }
+    return {
+      action: "pass",
+      severity: "note",
+      message: buildMessage("pass", "note", evidence),
+      evidence
+    };
+  }
+  if (risk === "medium") {
+    if (evidence.source === "none" || evidence.quality === "minimal") {
+      return {
+        action: "warn",
+        severity: "strong",
+        message: buildMessage("warn", "strong", evidence),
+        evidence
+      };
+    }
+    if (evidence.source === "tree-sitter" || evidence.source === "token-scan") {
+      return {
+        action: "warn",
+        severity: "normal",
+        message: buildMessage("warn", "normal", evidence),
+        evidence
+      };
+    }
+    return {
+      action: "pass",
+      severity: "note",
+      message: buildMessage("pass", "note", evidence),
+      evidence
+    };
+  }
+  if (evidence.source === "none" || evidence.quality === "minimal") {
+    return {
+      action: "warn",
+      severity: "note",
+      message: buildMessage("warn", "note", evidence),
+      evidence
+    };
+  }
+  return {
+    action: "pass",
+    severity: "note",
+    message: buildMessage("pass", "note", evidence),
+    evidence
+  };
+}
+
 // src/tools/filesystem/FileEditTool/FileEditTool.tsx
 var inputSchema3 = z3.strictObject({
   file_path: z3.string().describe("The absolute path to the file to modify"),
@@ -6677,7 +6847,7 @@ var FileEditTool = {
     const originalFileContent = currentFileContent;
     let totalPatch = [];
     const { SmartEdit } = await import("./smart-edit-AWHJDSU6.js");
-    const { findLspAnchor } = await import("./lspAnchor-5TJ5JKEJ.js");
+    const { findLspAnchor } = await import("./lspAnchor-YI3SOGER.js");
     for (const op of editOperations) {
       const normalizedSearch = normalizeLineEndings(op.search);
       const normalizedReplace = normalizeLineEndings(op.replace);
@@ -6727,7 +6897,24 @@ ${op.search}`);
         timeoutMs: 5e3,
         rootPath: getSessionRoot()
       });
+      const fallbackDecision = decideLspFallbackAction({
+        risk: "high",
+        verifyMode: true,
+        evidence: normalizeLspFallbackEvidence(lspResult)
+      });
+      if (fallbackDecision.action === "block") {
+        writeTextContent(fullFilePath, originalFileContent, enc, endings);
+        if (fallbackDecision.evidence.source === "none") {
+          throw new Error(
+            `Verification Unavailable: Unable to initialize LSP for ${file_path}. source=${fallbackDecision.evidence.source} quality=${fallbackDecision.evidence.quality}. Retry with verify=false or rerun when LSP is available.`
+          );
+        }
+        throw new Error(
+          `Verification Blocked: source=${fallbackDecision.evidence.source} quality=${fallbackDecision.evidence.quality} confidence=${fallbackDecision.evidence.confidence}. Retry with verify=false or rerun with higher-quality LSP evidence.`
+        );
+      }
       if (lspResult.formatted.startsWith("No LSP server available for file type:")) {
+        writeTextContent(fullFilePath, originalFileContent, enc, endings);
         throw new Error(
           `Verification Unavailable: Unable to initialize LSP for ${file_path}. Retry with verify=false or rerun when LSP is available.`
         );
@@ -8519,6 +8706,12 @@ var DESCRIPTION4 = `Fast file pattern matching tool that works with any codebase
   - Search ignores .gitignore rules and includes hidden files by default.
   - **Empty Results**: When no files are found, try broader patterns (e.g., src/**/*) or verify path exists.
   - **Error Handling**: Returns error if \`path\` does not exist or is not a valid directory.
+  - **LSP Semantic Mode**: \`semantic: true\` enables workspace symbol fallback when file globbing returns empty.
+  - **Semantic search is opt-in**: Only set \`semantic: true\` when you intentionally want LSP-assisted fallback.
+  - Semantic output may include:
+    - \`semanticNotice\`: human-readable semantic fallback note
+    - \`semanticReason\`: structured reason code (e.g., \`SYMBOLS_ADDED\`, \`NO_SYMBOL_MATCH\`, \`LSP_UNAVAILABLE\`)
+    - \`semanticSuggestion\`: suggested next action aligned to reason code
   - **Truncated Results**: When results are truncated (limited to 100 files), narrow down using:
     1. Add a more specific path: \`src/core/**/*.ts\` instead of \`**/*.ts\`
     2. Use file extension filter: \`src/**/*.test.ts\` instead of \`src/**/*.ts\`
@@ -8564,6 +8757,20 @@ var DESCRIPTION4 = `Fast file pattern matching tool that works with any codebase
   [uses Glob tool with pattern="src/**/*.ts" to focus on source code]
   [uses Glob tool with pattern="src/core/**/*.ts" to narrow further if needed]
   </example>
+
+  ### Example 6: Semantic Fallback for Unknown File Path
+  <example>
+  user: Find where AuthService is implemented, I do not know the file name
+  assistant: [uses Glob tool with pattern="**/*AuthService*" semantic=false first]
+  [if no files found, retries with semantic=true]
+  [reads semanticReason and semanticSuggestion to decide next step]
+  <reasoning>
+  The assistant switches to semantic mode because:
+  1. Filename-based glob failed and user intent is symbol-oriented
+  2. semantic=true allows LSP workspace symbols to recover likely file paths
+  3. semanticReason + semanticSuggestion provide explicit fallback diagnostics
+  </reasoning>
+  </example>
 `.trim();
 
 // src/tools/filesystem/GlobTool/GlobTool.tsx
@@ -8831,6 +9038,12 @@ var DESCRIPTION5 = `A powerful fast content search tool that works with any code
   **Result Handling**:
   - Results are truncated at 20,000 characters if too large
   - Use Task tool for open-ended searches requiring multiple rounds
+  - **Semantic Fallback** (\`semantic: true\`): when text grep has no hit (or \`symbol_type\` is provided), Grep can query LSP workspace symbols.
+  - Semantic-enhanced outputs may include:
+    - \`semanticNotice\`: fallback summary
+    - \`semanticReason\`: structured reason code (e.g., \`SYMBOLS_ADDED\`, \`NO_SYMBOL_MATCH\`, \`LSP_UNAVAILABLE\`)
+    - \`semanticSuggestion\`: suggested next action by reason code
+  - Keep deterministic workflow: text search first, semantic fallback second.
 
   **Typical Usage Examples**:
 
@@ -8869,6 +9082,20 @@ var DESCRIPTION5 = `A powerful fast content search tool that works with any code
   assistant: [uses Grep tool with pattern="database.*host|db_host|DB_HOST" -i: true]        
   [uses Read tool to examine configuration files]
   </example>
+
+  Example 6: Semantic Fallback with Structured Reason
+  <example>
+  user: Find usages of PaymentSrvce (name might be misspelled)
+  assistant: [uses Grep tool with pattern="PaymentSrvce" output_mode="files_with_matches"]
+  [if no hit, retries with semantic=true]
+  [uses semanticReason and semanticSuggestion to decide whether to broaden query or switch to LspTool]
+  <reasoning>
+  The assistant uses semantic fallback because:
+  1. Text grep may miss typo-tolerant symbol matches
+  2. LSP workspace symbols can recover intended semantic targets
+  3. Structured reason fields make fallback outcomes explicit and actionable
+  </reasoning>
+  </example>
   `.trim();
 
 // src/tools/search/GrepTool/GrepTool.tsx
@@ -12565,7 +12792,7 @@ async function createAndStoreApiKey(accessToken) {
       }
       saveGlobalConfig(config2);
       try {
-        const { resetAnthropicClient } = await import("./llm-OTA3UYTD.js");
+        const { resetAnthropicClient } = await import("./llm-QPAHJ643.js");
         resetAnthropicClient();
       } catch {
       }
@@ -16989,7 +17216,7 @@ async function refreshPluginRuntimeFromInstalls() {
   const existingRoots = getSessionPlugins().map((p) => p.rootDir);
   const dirs = Array.from(/* @__PURE__ */ new Set([...existingRoots, ...installedRoots]));
   if (dirs.length === 0) return [];
-  const { configureSessionPlugins } = await import("./pluginRuntime-3CCOPRUZ.js");
+  const { configureSessionPlugins } = await import("./pluginRuntime-TLFHDTDH.js");
   const { errors } = await configureSessionPlugins({ pluginDirs: dirs });
   return errors;
 }
@@ -17664,7 +17891,7 @@ async function call(onDone, context) {
     ModelConfig,
     {
       onClose: () => {
-        import("./model-XIQ6J7WO.js").then(({ reloadModelManager: reloadModelManager2 }) => {
+        import("./model-JFUZ777G.js").then(({ reloadModelManager: reloadModelManager2 }) => {
           reloadModelManager2();
           triggerModelConfigChange();
           onDone();
@@ -27621,7 +27848,41 @@ var PROMPT7 = `- Retrieves output from a running or completed task (background s
 - Use block=true (default) to wait for task completion
 - Use block=false for non-blocking check of current status
 - Task IDs can be found using the /tasks command
-- Works with all task types: background shells, async agents, and remote sessions`;
+- Works with all task types: background shells, async agents, and remote sessions
+
+## LSP-Integrated Analysis
+- Optional \`analyze: true\` can append diagnostics-oriented analysis for task outputs.
+- LSP analysis execution is gated by environment flag \`PYB_TASKOUTPUT_LSP_ANALYSIS\` (1/true/on/yes).
+- If enabled, TaskOutput attempts semantic diagnostics enrichment for files mentioned in output.
+- If LSP analysis fails, TaskOutput emits structured fallback telemetry (\`LSP_TOOL_FALLBACK\`) and continues returning task output.
+- Treat analysis as augmentation: source-of-truth remains the original task output.
+
+## Typical Usage Examples
+### Example 1: Build Failure Triage with LSP Analysis
+<example>
+user: Check task 123 and tell me why build failed
+assistant: [uses TaskOutput with task_id="123" block=true analyze=true]
+[inspects task output first, then uses appended LSP diagnostics hints for root-cause localization]
+<reasoning>
+The assistant uses analyze=true because:
+1. User asks for failure diagnosis, not only raw logs
+2. LSP diagnostics can map errors to concrete file/line issues
+3. Raw task output is still preserved as authoritative evidence
+</reasoning>
+</example>
+
+### Example 2: Non-Blocking Polling During Long Task
+<example>
+user: Keep checking task 456 without waiting for completion
+assistant: [uses TaskOutput with task_id="456" block=false analyze=false]
+[repeats polling as needed; enables analyze=true only when failure appears]
+<reasoning>
+The assistant defers analysis because:
+1. Task is still running, so output is incomplete
+2. Non-blocking polling reduces wait latency
+3. Diagnostics enrichment is most useful after stable failure output appears
+</reasoning>
+</example>`;
 
 // src/tools/system/TaskOutputTool/TaskOutputTool.tsx
 var TOOL_PROGRESS_OPEN_TAG2 = ["<tool", "-progress>"].join("");
@@ -27707,7 +27968,7 @@ async function analyzeOutputWithLsp(output, exitCode) {
   if (exitCode !== 0 || errorCount > 0 || warningCount > 0) {
     try {
       const { isAbsolute: isAbsolute11, resolve: resolve16 } = await import("path");
-      const { getSessionRoot: getSessionRoot2 } = await import("./state-QUWQKTQZ.js");
+      const { getSessionRoot: getSessionRoot2 } = await import("./state-MDP57623.js");
       const lines = output.split("\n");
       const uniqueFiles = /* @__PURE__ */ new Set();
       const lspSuggestions = [];
@@ -27990,6 +28251,10 @@ Usage:
 - Supports recursive deletion for directories (be careful!).
 - Safe and cross-platform (works on Windows/Linux/Mac).
 - Do NOT use BashTool/RunCommand with 'rm', 'del', or 'rmdir'.
+- Default behavior includes an LSP reference safety check before deletion.
+- If references are detected, deletion is blocked unless \`force: true\` is explicitly set.
+- If LSP safety check fails internally, deletion is blocked unless \`force: true\` is explicitly set.
+- Use \`force: true\` only when you have validated impact (for example via LspTool findReferences or reviewed call sites with Read).
 
 Examples:
 
@@ -28008,6 +28273,18 @@ Delete({
 })
 </example_force>
 
+<example_lsp_guard>
+// Deletion blocked by LSP reference guard, then explicitly overridden
+Delete({
+  file_paths: ["/absolute/path/to/legacy-api.ts"]
+})
+// if blocked with "Safety Check Failed", validate impact first, then:
+Delete({
+  file_paths: ["/absolute/path/to/legacy-api.ts"],
+  force: true
+})
+</example_lsp_guard>
+
 <example_directory>
 // Deleting a directory recursively
 Delete({
@@ -28092,7 +28369,7 @@ var DeleteTool = {
         }
         if (!force) {
           try {
-            const { LspFacade: LspFacade2 } = await import("./lsp-EIMYRWRU.js");
+            const { LspFacade: LspFacade2 } = await import("./lsp-WIEWEHYU.js");
             const referenceDetail = await LspFacade2.checkFileReferences(fullPath);
             if (referenceDetail) {
               failedItems.push(
@@ -28102,8 +28379,20 @@ var DeleteTool = {
             }
           } catch (e) {
             if (!force) {
+              const decision = decideLspFallbackAction({
+                risk: "high",
+                allowForce: Boolean(force),
+                evidence: normalizeLspFallbackEvidence({
+                  source: "none",
+                  quality: "minimal",
+                  confidence: "low",
+                  fallbackReason: "lsp-runtime-error",
+                  fallbackSuggestion: "Use 'force: true' to override when safety checks are unavailable.",
+                  formatted: String(e?.message ?? e)
+                })
+              });
               failedItems.push(
-                `${rawPath} (Safety Check Failed: Internal LSP Error. Use 'force: true' to override.)`
+                `${rawPath} (Safety Check Failed: Internal LSP Error. source=${decision.evidence.source} quality=${decision.evidence.quality}. Use 'force: true' to override.)`
               );
               continue;
             }
@@ -28453,6 +28742,33 @@ If the specified position is not on a valid symbol, the tool automatically searc
 - **workspaceSymbol**: Must provide scoped filePath (module or directory), avoid unbounded full-repo queries
 - **documentSymbol**: Uses LspFacade policy (LSP-first for accuracy, Tree-Sitter fallback for speed)
 
+## Typical Usage Examples
+### Example 1: Find Symbol Then Read Precise Block
+<example>
+user: Locate JWT validation implementation quickly
+assistant: [uses LSP workspaceSymbol with query="jwt validate" and scoped filePath]
+[uses Read on the discovered file and then LSP documentSymbol/definition as needed]
+<reasoning>
+The assistant starts semantically because:
+1. User asks for implementation location, not broad text grep
+2. workspaceSymbol narrows candidate files efficiently
+3. Read is then used for exact code extraction once target is known
+</reasoning>
+</example>
+
+### Example 2: Diagnostics-First Debugging
+<example>
+user: Build failed in api package, tell me real code errors
+assistant: [uses LSP diagnostics with waitForDiagnostics=true on scoped filePath]
+[uses goToDefinition/findReferences for follow-up impact tracing]
+<reasoning>
+The assistant prioritizes diagnostics because:
+1. Diagnostics provide direct semantic errors from language tooling
+2. Scoped path avoids unbounded workspace queries
+3. Follow-up LSP ops can trace root-cause dependencies
+</reasoning>
+</example>
+
 Note: LSP servers are automatically managed and installed for most languages. For system-level languages (like C++, Java), ensure the corresponding tools (clangd, jdtls) are in your PATH.`;
 var DESCRIPTION10 = PROMPT11;
 
@@ -38494,7 +38810,7 @@ function useStatusLine() {
 // src/ui/components/PromptInput.tsx
 async function interpretHashCommand(input) {
   try {
-    const { queryQuick: queryQuick2 } = await import("./llm-OTA3UYTD.js");
+    const { queryQuick: queryQuick2 } = await import("./llm-QPAHJ643.js");
     const systemPrompt = [
       "You're helping the user structure notes that will be added to their PYB.md file.",
       "Format the user's input into a well-structured note that will be useful for later reference.",
@@ -38807,7 +39123,7 @@ function PromptInput({
     if (messages2.length) {
       if (mode === "bash") {
         onQuery(messages2, newAbortController).then(async () => {
-          const { getCwd: getCwd2 } = await import("./state-QUWQKTQZ.js");
+          const { getCwd: getCwd2 } = await import("./state-MDP57623.js");
           setCurrentPwd(getCwd2());
         });
       } else {
@@ -40437,7 +40753,7 @@ import { homedir as homedir8 } from "os";
 // src/commands/agents/generation.ts
 import { randomUUID as randomUUID9 } from "crypto";
 async function generateAgentWithClaude(prompt) {
-  const { queryModel } = await import("./llm-OTA3UYTD.js");
+  const { queryModel } = await import("./llm-QPAHJ643.js");
   const systemPrompt = `You are an expert at creating AI agent configurations. Based on the user's description, generate a specialized agent configuration.
 
 Return your response as a JSON object with exactly these fields: