Add CTags Symbol Conversion For LSP

Add a conversion path from CTags symbol output into LSP `SymbolInformation`, allowing parsed tags to be surfaced with mapped kinds, source ranges, and file locations. The CTags parser now carries the originating filename through symbol metadata so converted symbols can point back to the correct source file.

Also improve LSP path conversion documentation and override declarations in the default path converter, clarifying how local, remote, and file URI paths are normalized.

* CTags symbol parsing
* LSP symbol mapping
* Path converter docs and overrides

**Generated by CodeLite**

Signed-off-by: Eran Ifrah <eran@codelite.org>

Author: eranif

CodeLite/CTags.cpp

@@ -141,7 +141,7 @@ std::optional<wxString> CTags::DoSymbolGenerate(const wxString& file, const wxSt
     return wxString::FromUTF8(result.out);
 }
 
-std::vector<CTags::SymbolInfo> CTags::ParseSymbolOutput(const wxString& content)
+std::vector<CTags::SymbolInfo> CTags::ParseSymbolOutput(const wxString& content, const wxString& filename)
 {
     std::vector<SymbolInfo> out;
     wxArrayString lines = ::wxStringTokenize(content, "\n", wxTOKEN_STRTOK);
@@ -171,6 +171,7 @@ std::vector<CTags::SymbolInfo> CTags::ParseSymbolOutput(const wxString& content)
             info.name = name;
             info.kind = *mapped_kind;
             info.line = entry["line"].get<int>();
+            info.file = filename;
             if (entry.contains("end") && entry["end"].is_number_integer()) {
                 info.end_line = entry["end"].get<int>();
             }
@@ -223,7 +224,7 @@ std::vector<CTags::SymbolInfo> CTags::ParseFileSymbols(const wxString& file, con
         return {};
 
     clDEBUG() << "Parsing symbols..." << endl;
-    auto symbols = ParseSymbolOutput(*content);
+    auto symbols = ParseSymbolOutput(*content, file);
     clDEBUG() << "Parsing symbols...done" << endl;
 
     clDEBUG() << "Sorting symbols..." << endl;

CodeLite/CTags.hpp

@@ -26,6 +26,7 @@ class WXDLLIMPEXP_CL CTags
 
     struct SymbolInfo {
         wxString name;
+        wxString file;
         SymbolKind kind = SymbolKind::kFunction;
         int line = 0;
         /**
@@ -187,7 +188,7 @@ class WXDLLIMPEXP_CL CTags
 
     static std::optional<wxString> DoSymbolGenerate(const wxString& file, const wxString& ctags_exe);
     static bool IsSupportedSymbolLanguage(const wxString& language);
-    static std::vector<SymbolInfo> ParseSymbolOutput(const wxString& content);
+    static std::vector<SymbolInfo> ParseSymbolOutput(const wxString& content, const wxString& filename);
     static std::optional<SymbolKind>
     MapSymbolKind(const wxString& kind, const wxString& scope, const wxString& kind_from_ctags);
 

CodeLite/LSP/basic_types.cpp

@@ -363,6 +363,43 @@ JSONItem SymbolInformation::ToJSON() const
     return json;
 }
 
+SymbolInformation SymbolInformation::From(const CTags::SymbolInfo& ctags_symbol_info)
+{
+    SymbolInformation si;
+    si.name = ctags_symbol_info.name + ctags_symbol_info.signature;
+    switch (ctags_symbol_info.kind) {
+    case CTags::SymbolKind::kClass:
+        si.kind = eSymbolKind::kSK_Class;
+        break;
+    case CTags::SymbolKind::kFunction:
+        si.kind = eSymbolKind::kSK_Method;
+        break;
+    case CTags::SymbolKind::kGlobalMethod:
+        si.kind = eSymbolKind::kSK_Function;
+        break;
+    case CTags::SymbolKind::kPrototype:
+        si.kind = eSymbolKind::kSK_Function;
+        break;
+    case CTags::SymbolKind::kStruct:
+        si.kind = eSymbolKind::kSK_Struct;
+        break;
+    case CTags::SymbolKind::kTrait:
+        si.kind = eSymbolKind::kSK_Interface;
+        break;
+    default:
+        si.kind = eSymbolKind::kSK_Variable;
+        break;
+    }
+    Range range;
+    range.SetStart(Position{ctags_symbol_info.line, 0});
+    if (ctags_symbol_info.end_line.has_value()) {
+        range.SetEnd(Position{ctags_symbol_info.end_line.value(), 0});
+    }
+    si.location.SetRange(range);
+    si.location.SetPath(ctags_symbol_info.file);
+    return si;
+}
+
 std::vector<SymbolInformation> SymbolInformation::From(const DocumentSymbol& document_symbol,
                                                        const wxString& container_name)
 {

CodeLite/LSP/basic_types.h

@@ -1,6 +1,7 @@
 #ifndef JSONRPC_BASICTYPES_H
 #define JSONRPC_BASICTYPES_H
 
+#include "CTags.hpp"
 #include "JSON.h"
 #include "JSONObject.h"
 #include "clModuleLogger.hpp"
@@ -656,6 +657,19 @@ class WXDLLIMPEXP_CL SymbolInformation : public Serializable
      */
     static std::vector<SymbolInformation> From(const DocumentSymbol& document_symbol,
                                                const wxString& container_name = wxEmptyString);
+
+    /**
+     * @brief Creates a SymbolInformation object from a ctags symbol description.
+     *
+     * Converts a CTags::SymbolInfo record into the internal SymbolInformation
+     * representation by mapping the symbol name, kind, and source range.
+     *
+     * @param ctags_symbol_info const CTags::SymbolInfo& The ctags symbol metadata to convert, including name,
+     *        signature, kind, and source line information.
+     *
+     * @return SymbolInformation The converted symbol information object.
+     */
+    static SymbolInformation From(const CTags::SymbolInfo& ctags_symbol_info);
 };
 
 enum class ProgressKind {

Plugin/LSP/PathConverterDefault.hpp

@@ -7,10 +7,33 @@
 class WXDLLIMPEXP_SDK PathConverterDefault : public IPathConverter
 {
 public:
-    virtual LSP::FilePath ConvertFrom(const wxString& path) const;
-    virtual LSP::FilePath ConvertTo(const wxString& path) const;
+    /**
+     * Convert a path string into an LSP::FilePath, normalizing URI/file URL forms and
+     * marking remote files when appropriate.
+     *
+     * This method decodes any URI-encoded characters, strips a leading "file://" prefix,
+     * and applies platform-specific adjustments. On Windows it also handles paths that
+     * arrive in "/C:/..." form and attempts to map known SFTP editor paths back to their
+     * local file paths. If the path does not exist locally on non-Windows systems, the
+     * result is flagged as a remote file.
+     *
+     * @param path const wxString& The input path or file URI to convert.
+     * @return LSP::FilePath The converted file path, with remote-file status set when needed.
+     */
+    LSP::FilePath ConvertFrom(const wxString& path) const override;
+    /**
+     * Converts a local editor file path into an LSP file path or file URL.
+     *
+     * This method checks whether the path corresponds to an open remote editor file.
+     * If so, it returns that editor's remote path prefixed with "file://". Otherwise,
+     * it falls back to the default wxWidgets filename-to-URL conversion.
+     *
+     * @param path const wxString& The local file path to convert.
+     * @return LSP::FilePath The converted file path or file URL.
+     */
+    LSP::FilePath ConvertTo(const wxString& path) const override;
     PathConverterDefault() = default;
-    virtual ~PathConverterDefault() = default;
+    ~PathConverterDefault() override = default;
 };
 
 #endif // PATHCONVERTERDEFAULT_HPP

TODO.md

@@ -23,7 +23,6 @@ Medium:
 - Support auto reading `AGENTS.md` file and convert it into System-Messages.
 - Implement `code_symbols` tool for AI.
 - Add tool management configuration which allows users to trust tools permanently
-- Move the history out of the JSON - it is not scalable. Need a directory structure.
 
 Low:
 ----