Function explainDiagnostic

vscode-extension/src/extension.ts:263–278

Command 7: explain the problem(s) at the cursor (read-only — no edits).

(documentUri?: vscode.Uri, range?: vscode.Range)

  vscode.window.showInformationMessage('QodeX is fixing the problem(s) in the terminal — the file will update on disk when it finishes.');
}

/** Command 7: explain the problem(s) at the cursor (read-only — no edits). */
async function explainDiagnostic(documentUri?: vscode.Uri, range?: vscode.Range): Promise<void> {
  const editor = vscode.window.activeTextEditor;
  const uri = documentUri ?? editor?.document.uri;
  if (!uri) { vscode.window.showWarningMessage('QodeX: no active file.'); return; }
  const r = range ?? editor?.selection;
  const { text, count } = collectDiagnostics(uri, r ?? undefined);
  if (count === 0) {
    vscode.window.showInformationMessage('QodeX: no problems at the cursor.');
    return;
  }
  const prompt =
    `Explain these problems in ${uri.fsPath} and how you'd fix them. Do NOT edit anything — just explain clearly:\n\n${text}`;
  const cfg = getConfig();
  const term = getOrCreateTerminal(getCwd());
  term.sendText(`${cfg.executablePath} ${cfg.openHeadless ? '--headless ' : ''}${shellQuote(prompt)}`);
}