@yaegassy/coc-ty 0.2.2 → 0.3.0

package/.serena/project.yml

@@ -0,0 +1,84 @@
+# list of languages for which language servers are started; choose from:
+#   al               bash             clojure          cpp              csharp           csharp_omnisharp
+#   dart             elixir           elm              erlang           fortran          go
+#   haskell          java             julia            kotlin           lua              markdown
+#   nix              perl             php              python           python_jedi      r
+#   rego             ruby             ruby_solargraph  rust             scala            swift
+#   terraform        typescript       typescript_vts   yaml             zig
+# Note:
+#   - For C, use cpp
+#   - For JavaScript, use typescript
+# Special requirements:
+#   - csharp: Requires the presence of a .sln file in the project folder.
+# When using multiple languages, the first language server that supports a given file will be used for that file.
+# The first language is the default language and the respective language server will be used as a fallback.
+# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
+languages:
+- typescript
+
+# the encoding used by text files in the project
+# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
+encoding: "utf-8"
+
+# whether to use the project's gitignore file to ignore files
+# Added on 2025-04-07
+ignore_all_files_in_gitignore: true
+
+# list of additional paths to ignore
+# same syntax as gitignore, so you can use * and **
+# Was previously called `ignored_dirs`, please update your config if you are using that.
+# Added (renamed) on 2025-04-07
+ignored_paths: []
+
+# whether the project is in read-only mode
+# If set to true, all editing tools will be disabled and attempts to use them will result in an error
+# Added on 2025-04-18
+read_only: false
+
+# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
+# Below is the complete list of tools for convenience.
+# To make sure you have the latest list of tools, and to view their descriptions, 
+# execute `uv run scripts/print_tool_overview.py`.
+#
+#  * `activate_project`: Activates a project by name.
+#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
+#  * `create_text_file`: Creates/overwrites a file in the project directory.
+#  * `delete_lines`: Deletes a range of lines within a file.
+#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
+#  * `execute_shell_command`: Executes a shell command.
+#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
+#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
+#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
+#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
+#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
+#  * `initial_instructions`: Gets the initial instructions for the current project.
+#     Should only be used in settings where the system prompt cannot be set,
+#     e.g. in clients you have no control over, like Claude Desktop.
+#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
+#  * `insert_at_line`: Inserts content at a given line in a file.
+#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
+#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
+#  * `list_memories`: Lists memories in Serena's project-specific memory store.
+#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
+#  * `read_file`: Reads a file within the project directory.
+#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
+#  * `remove_project`: Removes a project from the Serena configuration.
+#  * `replace_lines`: Replaces a range of lines within a file with new content.
+#  * `replace_symbol_body`: Replaces the full definition of a symbol.
+#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
+#  * `search_for_pattern`: Performs a search for a pattern in the project.
+#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
+#  * `switch_modes`: Activates modes by providing a list of their names
+#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
+#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
+#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
+#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
+excluded_tools: []
+
+# initial prompt for the project. It will always be given to the LLM upon activating the project
+# (contrary to the memories, which are loaded on demand).
+initial_prompt: ""
+
+project_name: "coc-ty"
+included_optional_tools: []

package/CLAUDE.md

@@ -0,0 +1,42 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+coc-ty is a coc.nvim extension that provides LSP support for the `ty` Python type checker (by Astral). It bridges the ty language server with Vim/Neovim through the coc.nvim framework.
+
+## Build Commands
+
+```bash
+yarn install    # Install dependencies
+yarn build      # Build using esbuild (src/index.ts -> lib/index.js)
+yarn watch      # Build with file watching for development
+yarn lint       # Run ESLint on src/ directory
+yarn clean      # Remove lib/ directory
+```
+
+No test framework is configured.
+
+## Architecture
+
+The extension follows a simple structure with ~150 lines of TypeScript:
+
+- **src/index.ts** - Extension entry point; exports `activate()` called by coc.nvim on `onLanguage:python`
+- **src/client.ts** - Creates and configures the LanguageClient with ServerOptions (ty binary + 'server' subcommand) and ClientOptions (document selector, initialization options, feature toggles)
+- **src/tool.ts** - Binary detection: checks `ty.path` setting first, then falls back to system PATH via `which`
+- **src/commands/** - Command handlers for `ty.restart` and `ty.showLogs`
+
+All user-facing configuration options are defined in `package.json` under `contributes.configuration`. The extension converts these settings into initialization options passed to the ty language server.
+
+## Key Integration Points
+
+- The ty binary is invoked with `server` subcommand to start LSP mode
+- Feature toggles (completion, diagnostics, hover, inlayHints, typeDefinition) are passed via ClientCapabilities disabled features
+- Root patterns for Python project detection: pyproject.toml, ty.toml, setup.py, setup.cfg, tox.ini, Pipfile, requirements.txt
+
+## Related Projects
+
+- [astral-sh/ty](https://github.com/astral-sh/ty) - The Python type checker
+- [ty-vscode](https://github.com/astral-sh/ty/tree/main/crates/ty_vscode) - VSCode extension this mirrors
+- [coc.nvim](https://github.com/neoclide/coc.nvim) - The Vim/Neovim LSP framework

package/lib/index.js

@@ -261,6 +261,41 @@ var import_coc = require("coc.nvim");
 var SERVER_SUBCOMMAND = "server";
 
 // src/client.ts
+var EXTENSION_ONLY_KEYS = {
+  // InitializationOptions
+  logLevel: true,
+  logFile: true,
+  // ExtensionSettings by coc-ty
+  enable: true,
+  disableCompletion: true,
+  disableDiagnostics: true,
+  disableHover: true,
+  disableInlayHint: true,
+  disableTypeDefinition: true,
+  path: true,
+  interpreter: true,
+  importStrategy: true,
+  trace: true
+};
+function isExtensionOnlyKey(key) {
+  return key in EXTENSION_ONLY_KEYS;
+}
+var configurationWorkspaceMiddleware = {
+  configuration: async (params, token, next) => {
+    const response = await next(params, token);
+    if (!Array.isArray(response)) {
+      return response;
+    }
+    return params.items.map((param, index) => {
+      const result = response[index];
+      if (param.section === "ty" && result && typeof result === "object") {
+        const serverSettings = Object.fromEntries(Object.entries(result).filter(([key]) => !isExtensionOnlyKey(key)));
+        return serverSettings;
+      }
+      return result;
+    });
+  }
+};
 function createServerClient(command) {
   const newEnv = { ...process.env };
   const args = [SERVER_SUBCOMMAND];
@@ -272,7 +307,10 @@ function createServerClient(command) {
   const clientOptions = {
     documentSelector: ["python"],
     initializationOptions: getInitializationOptions(),
-    disabledFeatures: getLanguageClientDisabledFeatures()
+    disabledFeatures: getLanguageClientDisabledFeatures(),
+    middleware: {
+      workspace: configurationWorkspaceMiddleware
+    }
   };
   const client2 = new import_coc.LanguageClient("ty", "ty server", serverOptions, clientOptions);
   return client2;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaegassy/coc-ty",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "coc.nvim extension with support for the ty type checker and language server.",
   "author": "yaegassy <yosstools@gmail.com>",
   "license": "MIT",
@@ -110,16 +110,30 @@
           "default": "",
           "description": "Custom path for the `ty` binary when using the native server. If no value is set, the `ty` command will be detected from the runtime environment."
         },
+        "ty.configuration": {
+          "default": null,
+          "markdownDescription": "Inline JSON configuration for ty settings. Overrides settings in a configuration file. For example\n\n```json\n{\n  \"rules\": {\n    \"unresolved-reference\": \"ignore\"\n  }\n}\n``` ",
+          "scope": "window",
+          "type": "object"
+        },
+        "ty.configurationFile": {
+          "default": null,
+          "markdownDescription": "Path to a `ty.toml` configuration file.",
+          "scope": "window",
+          "type": "string"
+        },
         "ty.diagnosticMode": {
           "default": "openFilesOnly",
           "markdownDescription": "Analysis scope for showing diagnostics.",
           "enum": [
             "openFilesOnly",
-            "workspace"
+            "workspace",
+            "off"
           ],
           "enumDescriptions": [
             "Analyzes and reports errors on only open files.",
-            "Analyzes and reports errors on all files in the workspace."
+            "Analyzes and reports errors on all files in the workspace.",
+            "Turn all diagnostics off. Use ty as a language server only."
           ],
           "scope": "resource",
           "type": "string"