canopus 0.5.0 → 0.6.0

data/lib/canopus/plugins/isolated_runtime.rb

@@ -26,7 +26,7 @@ module Canopus
       end
       def text
         permit!("read_buffer")
-        @context.fetch("text")
+        @context.fetch("text") { raise @context.fetch("text_error", "buffer text is not available") }
       end
       def files
         permit!("read_project")
@@ -96,47 +96,73 @@ module Canopus
   RUBY
 
       def initialize(workspace, source, path, permissions, timeout: 2)
-        @workspace, @permissions, @timeout = workspace, permissions.map { |permission| permission.to_s == "process" ? "exec" : permission.to_s }.uniq, timeout
+        @workspace, @plugin_id = workspace, path
+        @permissions, @timeout = permissions.map { |permission| permission.to_s == "process" ? "exec" : permission.to_s }.uniq, timeout
+        @panel_lock = Mutex.new
+        @panel_cache, @panel_refreshed, @panel_refreshing, @panel_threads = {}, {}, {}, {}
+        @closed = false
         start_process
         @input.sync = true
         @output.binmode
         @pending, @lock = +"".b, Mutex.new
         @input.puts(JSON.generate(source: source, path: path, permissions: @permissions))
         manifest = response
+        servers = manifest.fetch("servers")
+        if !servers.empty? && !@permissions.include?("exec")
+          raise Canopus::Plugins::PermissionDenied, "plugin requires process to configure language servers"
+        end
         manifest.fetch("actions").each do |name, description|
           workspace.register_action(name, description: description) { invoke(:action, name) }
         end
         manifest.fetch("panels").each do |name, side|
-          workspace.register_panel(name, side: side.to_sym) { Zaniah::Text.new(invoke(:panel, name).to_s) }
+          workspace.register_panel(name, side: side.to_sym, cache: false) { panel_element(name) }
         end
+        @panel_names = manifest.fetch("panels").keys
         manifest.fetch("languages").each { |name, options| workspace.register_language(name, **options.transform_keys(&:to_sym)) }
-        workspace.settings.merge!("language_servers" => manifest.fetch("servers"))
+        servers.each { |language, command| workspace.configure_plugin_language_server(@plugin_id, language, command) }
       rescue StandardError
         close
         raise
       end
       def invoke(kind, name)
         @lock.synchronize do
-          buffer = @workspace.editor.buffer
-          version = buffer.version
+          raise Canopus::Error, "plugin runtime is closed" if @closed
+          buffer = @workspace.editor&.buffer
+          version = buffer&.version
           context = {root: @workspace.root}
-          context[:text] = buffer.text if @permissions.include?("read_buffer")
+          if @permissions.include?("read_buffer")
+            if buffer && buffer.rope.bytesize <= Plugins::BUFFER_CONTEXT_LIMIT
+              context[:text] = buffer.text
+            else
+              context[:text_error] = "plugin buffer text exceeds 1 MiB"
+            end
+          end
           context[:files] = @workspace.files if @permissions.include?("read_project")
           @input.puts(JSON.generate(kind: kind, name: name, context: context))
           result = response
           edits = result.fetch("edits")
           unless edits.empty?
             raise Canopus::Plugins::PermissionDenied, "plugin requires edit_buffer" unless @permissions.include?("edit_buffer")
-            raise Canopus::Error, "buffer changed while plugin was running" unless buffer.version == version
+            raise Canopus::Error, "buffer changed while plugin was running" unless buffer && buffer.version == version
             buffer.edit(edits.map { |first, last, text| [first...last, text] }, kind: :plugin)
           end
           @workspace.message = result.fetch("messages").last.to_s unless result.fetch("messages").empty?
+          refresh_panels if kind == :action
           result["result"]
         end
       rescue IOError, Errno::EPIPE, EOFError => error
         raise Canopus::Error, "plugin process ended: #{error.message}"
       end
       def close
+        threads = @panel_lock.synchronize do
+          @closed = true
+          @panel_threads.keys
+        end
+        threads.each do |thread|
+          next if thread.equal?(Thread.current)
+          thread.kill
+          thread.join(0.2)
+        end
         @input&.close unless @input&.closed?
         if @process && !@process.join(0.2)
           Process.kill("KILL", @pid) rescue Errno::ESRCH
@@ -145,6 +171,53 @@ module Canopus
         @output&.close unless @output&.closed?
       end
   private
+      def panel_element(name)
+        request_panel_refresh(name)
+        Zaniah::Text.new(@panel_lock.synchronize { @panel_cache.fetch(name, "") })
+      end
+
+      def request_panel_refresh(name)
+        now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        @panel_lock.synchronize do
+          return if @closed || @panel_refreshing[name]
+          return if @panel_refreshed[name] && now - @panel_refreshed[name] < 0.25
+
+          @panel_refreshing[name] = true
+        end
+        thread = Thread.new do
+          @panel_lock.synchronize do
+            if @closed
+              @panel_refreshing.delete(name)
+              next
+            end
+            @panel_threads[Thread.current] = true
+          end
+          begin
+            result = invoke(:panel, name)
+            @panel_lock.synchronize do
+              @panel_cache[name] = result.to_s
+              @panel_refreshed[name] = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+            end
+            @workspace.window&.request_frame
+          rescue StandardError => error
+            @workspace.message = error.message unless @closed
+          ensure
+            @panel_lock.synchronize do
+              @panel_refreshing.delete(name)
+              @panel_threads.delete(Thread.current)
+            end
+          end
+        end
+        thread
+      end
+
+      def refresh_panels
+        @panel_names&.each do |name|
+          visible = %i[left right bottom].any? { |side| @workspace.panels.active(side).any? { |definition| definition.id == name } }
+          request_panel_refresh(name) if visible
+        end
+      end
+
       def start_process
         command = [RbConfig.ruby, "-e", WORKER]
         mode = @workspace.settings["plugins"].fetch("sandbox", "auto")

data/lib/canopus/plugins/local_runtime.rb

@@ -4,7 +4,7 @@ module Canopus
   module Plugins
     class LocalRuntime
       def initialize(workspace, source, path, permissions)
-        @workspace, @api = workspace, Canopus::Plugins::API.new(workspace, permissions)
+        @workspace, @plugin_id, @api = workspace, path, Canopus::Plugins::API.new(workspace, permissions)
         instance_eval(source, path, 1)
       end
       def register_action(name, description: name, &block)
@@ -17,7 +17,8 @@ module Canopus
       end
       def register_language(name, **options) = @workspace.register_language(name, **options)
       def configure_lsp(language, command)
-        @workspace.settings.merge!("language_servers" => {language => command})
+        @api.permit!("process")
+        @workspace.configure_plugin_language_server(@plugin_id, language, command)
       end
       def close; end
     end

data/lib/canopus/plugins/vocabulary.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Canopus
+  module Plugins
+    module Vocabulary
+      module_function
+
+      def build
+        require "zaniah/ui"
+        Zaniah::Describe::Vocabulary.build do
+          node :column, props: {gap: :integer}, children: :many do |props, children|
+            Zaniah::Div.new.flex_col.style(gap: props.fetch(:gap, 0)).children(children)
+          end
+          node :row, props: {gap: :integer}, children: :many do |props, children|
+            Zaniah::Div.new.flex_row.style(gap: props.fetch(:gap, 0)).children(children)
+          end
+          node :text, props: {value: :string}, children: :none do |props|
+            Zaniah::Text.new(props.fetch(:value))
+          end
+          node :button, props: {label: :string, on_click: :handler}, children: :none do |props|
+            Zaniah::UI::Button.new(props.fetch(:label)).on_click { |event, _context| props.fetch(:on_click).call(event) }
+          end
+          node :list, props: {items: :array}, children: :none do |props|
+            Zaniah::Div.new.flex_col.children(Array(props.fetch(:items)).map { |item| Zaniah::Text.new(String(item)) })
+          end
+          node :spacer, props: {size: :number}, children: :none do |props|
+            Zaniah::UI::Spacer.new(props[:size])
+          end
+          node :scroll, props: {axis: %i[vertical horizontal both]}, children: :one do |props, children|
+            axis = props.fetch(:axis, :vertical)
+            Zaniah::ScrollView.new(axis: axis == :both ? :both : axis).child(children.first)
+          end
+          node :divider, props: {axis: %i[horizontal vertical]}, children: :none do |props|
+            Zaniah::UI::Divider.new(axis: props.fetch(:axis, :horizontal))
+          end
+          node :icon, props: {name: %i[check close search menu info warning], label: :string}, children: :none do |props|
+            Zaniah::UI::Icon.new(props.fetch(:name), label: props[:label])
+          end
+          node :badge, props: {value: :string, variant: %i[neutral accent success warning danger]}, children: :none do |props|
+            Zaniah::UI::Badge.new(props.fetch(:value), variant: props.fetch(:variant, :neutral))
+          end
+          node :progress, props: {value: :number, min: :number, max: :number, label: :string}, children: :none do |props|
+            Zaniah::UI::ProgressBar.new(value: props[:value], min: props.fetch(:min, 0), max: props.fetch(:max, 100), label: props[:label])
+          end
+          node :code, props: {value: :string}, children: :none do |props|
+            Zaniah::Text.new(props.fetch(:value)).style(font_family: :monospace)
+          end
+          node :checkbox, props: {label: :string, value: :boolean, on_change: :handler}, children: :none do |props|
+            Zaniah::UI::Checkbox.new(props.fetch(:label), value: props.fetch(:value, false))
+              .on_change { |value, _event, _context| props.fetch(:on_change).call(value) }
+          end
+          node :text_field, props: {value: :string, placeholder: :string, on_change: :handler}, children: :none do |props|
+            Zaniah::UI::TextField.new(props.fetch(:value, ""), placeholder: props[:placeholder])
+              .on_change { |value, _context| props.fetch(:on_change).call(value) }
+          end
+          node :select, props: {items: :array, value: :any, label: :string, on_change: :handler}, children: :none do |props|
+            Zaniah::UI::Select.new(props.fetch(:items), value: props[:value], label: props.fetch(:label, "Select"))
+              .on_change { |value, _event, _context| props.fetch(:on_change).call(value) }
+          end
+          node :tree, props: {items: :array}, children: :none do |props|
+            Zaniah::UI::TreeView.new(Array(props.fetch(:items)))
+          end
+          node :section, props: {title: :string}, children: :many do |props, children|
+            Zaniah::Div.new.flex_col.gap(2).children([Zaniah::UI::Label.new(props.fetch(:title)), *children])
+          end
+        end
+      end
+    end
+  end
+end

data/lib/canopus/plugins.rb

@@ -2,11 +2,14 @@
 
 module Canopus
   module Plugins
+    BUFFER_CONTEXT_LIMIT = 1 << 20
     PERMISSIONS = %w[read_buffer edit_buffer read_project write_project exec process network].freeze
     autoload :PermissionDenied, "canopus/plugins/permission_denied"
     autoload :API, "canopus/plugins/api"
     autoload :LocalRuntime, "canopus/plugins/local_runtime"
     autoload :IsolatedRuntime, "canopus/plugins/isolated_runtime"
+    autoload :Host, "canopus/plugins/host"
+    autoload :Vocabulary, "canopus/plugins/vocabulary"
     autoload :Registry, "canopus/plugins/registry"
   end
 end

data/lib/canopus/provider.rb

@@ -9,7 +9,7 @@ module Canopus
       MAX_PROVIDERS = 64
       MAX_ITEMS = 10_000
       MAX_STRING = 65_536
-      PROVIDER_TIMEOUT = 10
+      PROVIDER_TIMEOUT = 0.2
 
       def initialize
         @completion, @inline, @sequence = {}, {}, 0

data/lib/canopus/settings/schema.rb

@@ -25,7 +25,8 @@ module Canopus
         "persistent_undo" => {"enabled" => true, "max_entries" => 1_000, "expire_days" => 30},
         "format_on_save" => false, "code_actions_on_save" => [], "format_on_save_timeout" => 2_000,
         "git" => {"inline_blame" => "off", "autofetch" => false, "autofetch_interval" => 180},
-        "plugins" => {"sandbox" => "auto"},
+        "plugins" => {"enabled" => true, "sandbox" => "auto", "directories" => [], "disabled" => [],
+          "limits" => {"memory_mb" => 256, "request_timeout_ms" => 2_000}, "settings" => {}},
         "recovery" => {"enabled" => true, "interval" => 5_000},
         "dock" => {"left" => {"size" => 220, "visible" => true}, "right" => {"size" => 260, "visible" => false},
           "bottom" => {"size" => 280, "visible" => false},
@@ -104,7 +105,13 @@ module Canopus
         "git" => {"type" => "object", "additionalProperties" => false, "required" => %w[inline_blame autofetch autofetch_interval], "properties" => {
           "inline_blame" => {"type" => "string", "enum" => %w[off cursor all]}, "autofetch" => {"type" => "boolean"}, "autofetch_interval" => {"type" => "integer", "minimum" => 10, "maximum" => 86_400}}},
         "plugins" => {"type" => "object", "additionalProperties" => false, "required" => ["sandbox"], "properties" => {
-          "sandbox" => {"type" => "string", "enum" => %w[off auto required]}}},
+          "enabled" => {"type" => "boolean"}, "sandbox" => {"type" => "string", "enum" => %w[off auto required]},
+          "directories" => {"type" => "array", "maxItems" => 64, "items" => {"type" => "string", "minLength" => 1}},
+          "disabled" => {"type" => "array", "maxItems" => 256, "uniqueItems" => true, "items" => {"type" => "string", "minLength" => 1, "maxLength" => 128, "pattern" => "^[A-Za-z0-9_.-]+$"}},
+          "limits" => {"type" => "object", "additionalProperties" => false, "properties" => {
+            "memory_mb" => {"type" => "integer", "minimum" => 1, "maximum" => 4096},
+            "request_timeout_ms" => {"type" => "integer", "minimum" => 1, "maximum" => 60_000}}},
+          "settings" => {"type" => "object"}}},
         "recovery" => {"type" => "object", "additionalProperties" => false, "required" => %w[enabled interval], "properties" => {"enabled" => {"type" => "boolean"}, "interval" => {"type" => "integer", "minimum" => 100, "maximum" => 3_600_000}}},
         "dock" => {"type" => "object", "properties" => {"left" => {"$ref" => "#/$defs/dock"}, "right" => {"$ref" => "#/$defs/dock"}, "bottom" => {"$ref" => "#/$defs/dock"}, "panels" => {"type" => "object", "maxProperties" => 1000, "additionalProperties" => {"$ref" => "#/$defs/panel"}}}},
         "languages" => {"type" => "object", "additionalProperties" => {"allOf" => [{"$ref" => "#"}, {"properties" => {"languages" => false, "debug_adapters" => false, "recovery" => false, "auto_save" => false, "auto_save_delay" => false, "persistent_undo" => false}}]}},

data/lib/canopus/settings.rb

@@ -293,7 +293,18 @@ module Canopus
     def validate_plugins!
       plugins = @values["plugins"]
       raise Error, "plugins must be an object" unless plugins.is_a?(Hash)
+      raise Error, "plugins.enabled must be true or false" unless [true, false].include?(plugins["enabled"])
       raise Error, "invalid plugins.sandbox" unless %w[off auto required].include?(plugins["sandbox"])
+      directories = plugins["directories"]
+      raise Error, "plugins.directories must be an array" unless directories.is_a?(Array) && directories.length <= 64 && directories.all? { |path| path.is_a?(String) && !path.empty? }
+      disabled = plugins["disabled"]
+      raise Error, "plugins.disabled must be an array" unless disabled.is_a?(Array) && disabled.length <= 256 && disabled.all? { |name| name.is_a?(String) && name.match?(/\A[A-Za-z0-9_.-]{1,128}\z/) }
+      limits = plugins["limits"]
+      raise Error, "plugins.limits must be an object" unless limits.is_a?(Hash)
+      memory, timeout = limits.values_at("memory_mb", "request_timeout_ms")
+      raise Error, "invalid plugins.limits.memory_mb" unless memory.is_a?(Integer) && memory.between?(1, 4_096)
+      raise Error, "invalid plugins.limits.request_timeout_ms" unless timeout.is_a?(Integer) && timeout.between?(1, 60_000)
+      raise Error, "plugins.settings must be an object" unless plugins["settings"].is_a?(Hash)
     end
 
     def validate_diagnostics!

data/lib/canopus/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Canopus
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

data/lib/canopus/workspace/file_change_aware.rb

@@ -24,6 +24,7 @@ module Canopus
       events = @watcher.poll
       invalidate_git unless events.empty?
       refresh_files unless events.empty?
+      notify_plugin_event("workspace/didChangeFiles", events.map { |event| {"type" => event.type.to_s, "path" => event.path} }) unless events.empty?
       if events.any? { |event| File.basename(event.path) == ".editorconfig" }
         invalidate_editorconfig
         apply_settings

data/lib/canopus/workspace/settings_aware.rb

@@ -99,6 +99,7 @@ module Canopus
       apply_settings
       errors = @settings.paths.filter_map { |path| Settings.file_diagnostics(path)&.last }.flatten
       @message = errors.empty? ? "Settings reloaded" : "Settings unchanged: #{errors.first.message}"
+      notify_plugin_event("settings/didChange", {"paths" => @settings.paths})
     rescue StandardError => error
       @settings = old if old
       publish_settings_diagnostics(@settings.paths) if @settings

data/lib/canopus/workspace/view.rb

@@ -203,9 +203,13 @@ module Canopus
           paint_element(badge, Zaniah::Bounds.new(area.right - 40, area.y + 5, 36, 22))
         end
         key = [definition.id, @workspace.editor&.buffer&.object_id, @workspace.editor&.buffer&.version, @theme.object_id]
-        @panel_cache ||= {}
-        @panel_cache.clear if @panel_cache.length > 50
-        element = @panel_cache[key] ||= definition.build.call
+        if @workspace.uncached_panel?(definition.id)
+          element = definition.build.call
+        else
+          @panel_cache ||= {}
+          @panel_cache.clear if @panel_cache.length > 50
+          element = @panel_cache[key] ||= definition.build.call
+        end
         element = Zaniah::Text.new(ui_text(element), color: @theme[:foreground]) unless element.is_a?(Zaniah::Element)
         panel = Zaniah::Div.new.w(area.width).h([area.height - 34, 0].max)
           .test_id("syrma:panel:#{instrumentation_component(definition.id)}").child(element)
@@ -913,6 +917,8 @@ module Canopus
       point = editor.buffer.rope.point_at(editor.primary.head)
       mode = @workspace.settings["vim_mode"] ? @workspace.vim.mode.to_s : "edit"
       left = "#{mode}    #{@workspace.message}"
+      plugin_status = @workspace.plugin_status_items.values.sort_by { |item| -item.fetch(:priority, 0) }.map { |item| item[:text] }.join("  ")
+      left = "#{left}  #{plugin_status}" unless plugin_status.empty?
       branch = @workspace.git&.branch
       left = "#{branch}    #{left}" if branch
       left = ":#{@workspace.vim.command_line}" if @workspace.settings["vim_mode"] && @workspace.vim.command_line

data/lib/canopus/workspace.rb

@@ -36,7 +36,8 @@ module Canopus
     attr_reader :panes, :active_pane, :buffers, :actions, :commands, :settings, :theme, :project, :clients, :root, :docks, :panels, :decorations, :providers, :minimap, :diagnostics, :breakpoints, :trust
     attr_reader :terminals, :active_terminal_index, :terminal_layout
     attr_accessor :window, :terminal_composition, :selected_project_path, :performance
-    attr_reader :message, :palette
+    attr_reader :message, :palette, :plugin_dialogs, :plugin_status_items
+    attr_writer :plugin_dialogs
 
     def initialize(root: Dir.pwd, settings: nil)
       @root = File.realpath(root)
@@ -50,6 +51,9 @@ module Canopus
       @actions = @commands = Command::Registry.new
       @clients, @vim_states = {}, {}
       @message = ""
+      @plugin_dialogs = []
+      @plugin_status_items = {}
+      @plugin_event_listeners = []
       @project = Project.new(@root) if defined?(Project)
       dock = @settings["dock"]
       @docks = %i[left right bottom].to_h do |side|
@@ -152,6 +156,14 @@ module Canopus
       @palette
     end
     def plugins = @plugins ||= Plugins::Registry.new(self)
+    def plugin_host = @plugin_host ||= Plugins::Host.new(self)
+    def discover_plugin_manifests(directories = nil)
+      configured = @settings["plugins"] || {}
+      return [] if configured["enabled"] == false
+      directories ||= [File.join(ENV["XDG_CONFIG_HOME"] || File.expand_path("~/.config"), "canopus", "plugins"),
+        File.join(@root, ".canopus", "plugins"), *Array(configured["directories"])]
+      plugin_host.discover(directories)
+    end
     def files
       return @files if @files
       @project_entries = @project ? @project.files(include_directories: true).to_a : []
@@ -162,6 +174,20 @@ module Canopus
       notify(@message) unless @message.empty?
       @message
     end
+    def on_plugin_event(&listener)
+      raise ArgumentError, "plugin event listener required" unless listener
+
+      @plugin_event_listeners << listener
+      Zaniah::Subscription.new { @plugin_event_listeners.delete(listener) }
+    end
+    def notify_plugin_event(method, payload = nil)
+      @plugin_event_listeners.dup.each do |listener|
+        listener.call(method, payload)
+      rescue StandardError => error
+        @message = error.message
+      end
+      nil
+    end
     def notify(text, now: Process.clock_gettime(Process::CLOCK_MONOTONIC))
       @notifications ||= []
       @notification_id = (@notification_id || 0) + 1
@@ -210,6 +236,7 @@ module Canopus
       apply_editor_settings(opened)
       @project_tree&.reveal(absolute.delete_prefix(@root + File::SEPARATOR))
       invalidate_hidden_selection_ranges
+      notify_plugin_event("buffer/didOpen", opened.buffer)
       @window&.request_frame
       opened
     end
@@ -286,6 +313,7 @@ module Canopus
           self.message = "File saved; language server notification failed: #{error.message}"
         end
       end
+      notify_plugin_event("buffer/didSave", buffer)
       result
     end
 
@@ -323,6 +351,7 @@ module Canopus
       opened = @active_pane.open(buffer)
       apply_editor_settings(opened)
       invalidate_hidden_selection_ranges
+      notify_plugin_event("buffer/didOpen", opened.buffer)
       opened
     end
     def focus(pane)
@@ -363,6 +392,7 @@ module Canopus
       raise Error, "buffer has unsaved changes" if current.buffer.dirty? && !discard
       pane = @panes.find { |item| item.editors.include?(current) }
       raise Error, "editor is not in workspace" unless pane
+      closes_buffer = buffer_refs(current.buffer).length == 1
       closed = if current.buffer.path && !current.buffer.dirty?
         ClosedTab.new(current.buffer.path, current.selections.map { |selection| [selection.anchor, selection.head] },
           current.scroll_x, current.scroll_y, pane.object_id, pane.editors.index(current))
@@ -382,6 +412,7 @@ module Canopus
       pane.close(current, discard: discard, activate: @settings["tabs"]["activate_on_close"].to_sym)
       release_buffer(current.buffer, discard: discard)
       sources.each { |source| release_buffer(source, discard: discard) }
+      notify_plugin_event("buffer/didClose", current.buffer) if closes_buffer
       remember_closed_tab(closed) if closed
       close_empty_pane(pane) if pane.editors.empty?
     end
@@ -674,11 +705,20 @@ module Canopus
       dock = @docks.fetch(side)
       dock[:visible] = !dock[:visible]
     end
-    def register_panel(name, side: :left, &render)
-      definition = @panels.register(Panel::Definition.new(name, name.to_s, nil, side, render, nil))
+    def register_panel(name, title: name.to_s, side: :left, cache: true, &render)
+      definition = @panels.register(Panel::Definition.new(name, title.to_s, nil, side, render, nil))
+      (@uncached_panels ||= {})[definition.id] = true unless cache
       register_action("panel.#{name}") { @panels.show(definition.id) }
       definition
     end
+    def uncached_panel?(id) = !!@uncached_panels&.key?(id.to_s)
+    def configure_plugin_language_server(plugin, language, command)
+      language = String(language)
+      raise ArgumentError, "language server language must not be empty" if language.empty?
+      @settings.merge!("language_servers" => {language => command})
+      @message = "Plugin #{File.basename(plugin.to_s)} configured language server #{language}: #{JSON.generate(command)}"
+      command
+    end
     def register_action(name, description: name, category: name.to_s.split(".", 2).first, condition: "", keybinding: Command::DEFAULT_KEYBINDINGS[name.to_s], &block)
       @commands.register(Command::Definition.new(name.to_s, description, category, condition, block, keybinding))
     end
@@ -1115,6 +1155,7 @@ module Canopus
       @palette&.dig(:response)&.fulfill({"applied" => false, "failureReason" => "Workspace closed"})
       self.palette = nil
       @plugins&.close
+      @plugin_host&.shutdown
       failure = nil
       cleanup = lambda do |&operation|
         operation.call

data/sig/canopus.rbs

@@ -366,6 +366,8 @@ module Canopus
     attr_reader minimap: Minimap
     attr_accessor message: String
     def notify: (String text, ?now: Numeric) -> Integer
+    def on_plugin_event: () { (String, untyped) -> void } -> Zaniah::Subscription
+    def notify_plugin_event: (String method, ?untyped payload) -> nil
     def notifications: () -> Array[{id: Integer, text: String, expires: Numeric}]
     def dismiss_notification: (Integer id) -> void
     def expire_notifications: (?Numeric now) -> bool
@@ -409,8 +411,10 @@ module Canopus
     def resize_terminal: (Integer columns, Integer rows, ?final: bool, ?now: Numeric, ?terminal: Tarazed::PTY?) -> void
     def flush_terminal_resize: () -> void
     def toggle_dock: (Symbol side) -> bool
-    def register_panel: (String name, ?side: Panel::dock) { () -> (Zaniah::Element | String) } -> Panel::Definition
+    def register_panel: (String name, ?title: String, ?side: Panel::dock, ?cache: bool) { () -> (Zaniah::Element | String) } -> Panel::Definition
     def register_action: (String name, ?description: String, ?category: String, ?condition: String, ?keybinding: Command::keybinding) { (*untyped) -> untyped } -> Command::Definition
+    def uncached_panel?: (String id) -> bool
+    def configure_plugin_language_server: (String plugin, String language, untyped command) -> untyped
     def definition_for: (String? path) -> Language::Definition
     def register_language: (String name, extensions: Array[String], ?lexer: String, ?comment: String, ?indent_open: String, ?indent_close: String, ?servers: Array[Array[String]]) -> untyped
     def command_context: (?terminal: bool, ?task_output: bool) -> Command::context
@@ -481,11 +485,30 @@ module Canopus
     def drain: () -> void
     def close: () -> void
     def plugins: () -> Plugins::Registry
+    def plugin_host: () -> Plugins::Host
+    def discover_plugin_manifests: (?Array[String] directories) -> Array[untyped]
+    attr_reader plugin_dialogs: Array[Hash[Symbol, untyped]]
+    attr_writer plugin_dialogs: Array[Hash[Symbol, untyped]]
+    attr_reader plugin_status_items: Hash[untyped, Hash[Symbol, untyped]]
   end
 
   module Plugins
     class PermissionDenied < Error
     end
+    class Host
+      attr_reader runtime: untyped
+      def initialize: (Workspace workspace, ?sandbox: bool, ?limits: Hash[Symbol, Numeric]) -> void
+      def discover: (Array[String] directories) -> Array[untyped]
+      def add: (untyped manifest) -> untyped
+      def activate: (String id, reason: String) -> untyped?
+      def deactivate: (String id) -> untyped
+      def instances: () -> Array[untyped]
+      def shutdown: () -> untyped
+      def status_items: () -> Hash[untyped, untyped]
+    end
+    module Vocabulary
+      def self.build: () -> untyped
+    end
     class API
       def text: () -> String
       def replace: (Range[Integer] range, String text) -> patch?

data/tools/check_dependencies.rb

@@ -13,7 +13,7 @@ smoke = ARGV.first && File.expand_path(ARGV.fetch(0))
 abort "Usage: ruby tools/check_dependencies.rb [smoke.rb]" if ARGV.length > 1 || (smoke && !File.file?(smoke))
 specification = Gem::Specification.load(File.join(root, "#{entry}.gemspec"))
 dependencies = specification.runtime_dependencies.map(&:name).sort
-expected = %w[alhena alkaid antares denebola editorconfig kochab megrez menkar porrima prism rexml rouge sadr saiph spica tarazed thuban timeout unicode-display_width zaniah]
+expected = %w[alhena alkaid antares denebola editorconfig gienah kochab megrez menkar porrima prism rexml rouge sadr saiph spica tarazed thuban timeout unicode-display_width zaniah]
 abort "unexpected runtime gem dependencies" unless dependencies == expected
 abort "native extension declaration" unless specification.extensions.empty?
 abort "packaged native binary" if specification.files.any? { |path| path.match?(/\.(?:so|bundle|dll|dylib|a|o)\z/i) }
@@ -32,10 +32,10 @@ Dir.mktmpdir("#{entry}-install-") do |directory|
   gem_command = File.join(RbConfig::CONFIG.fetch("bindir"), "gem")
   environment = ENV.each_key.grep(/\ABUNDLE/).to_h { |key| [key, nil] }.merge(
     "GEM_HOME" => installation, "GEM_PATH" => ([installation] + Gem.path).join(File::PATH_SEPARATOR),
-    "RUBYLIB" => nil, "RUBYOPT" => nil, "ALKAID_PATH" => nil, "ANTARES_PATH" => nil,
+    "RUBYLIB" => nil, "RUBYOPT" => nil, "GIENAH_PATH" => nil, "ZANIAH_PATH" => nil, "ALKAID_PATH" => nil, "ANTARES_PATH" => nil,
     "MEGREZ_PATH" => nil, "MENKAR_PATH" => nil, "SADR_PATH" => nil, "SAIPH_PATH" => nil, "TARAZED_PATH" => nil
   )
-  {"ALKAID_PATH" => "alkaid", "ANTARES_PATH" => "antares", "MEGREZ_PATH" => "megrez", "MENKAR_PATH" => "menkar", "SADR_PATH" => "sadr", "SAIPH_PATH" => "saiph",
+  {"GIENAH_PATH" => "gienah", "ZANIAH_PATH" => "zaniah", "ALKAID_PATH" => "alkaid", "ANTARES_PATH" => "antares", "MEGREZ_PATH" => "megrez", "MENKAR_PATH" => "menkar", "SADR_PATH" => "sadr", "SAIPH_PATH" => "saiph",
    "TARAZED_PATH" => "tarazed"}.each do |variable, name|
     next unless ENV[variable]
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: canopus
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Yudai Takada
@@ -79,6 +79,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.2.2
+- !ruby/object:Gem::Dependency
+  name: gienah
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: kochab
   requirement: !ruby/object:Gem::Requirement
@@ -293,14 +307,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.2
+        version: 0.6.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.2
+        version: 0.6.0
 email:
 - t.yudai92@gmail.com
 executables:
@@ -333,8 +347,8 @@ files:
 - docs/distribution.md
 - docs/lsp.md
 - docs/performance.md
+- docs/plugins.md
 - docs/providers.md
-- docs/release-log.md
 - docs/snippets.md
 - docs/tasks.md
 - docs/testing.md
@@ -393,10 +407,12 @@ files:
 - lib/canopus/performance_recorder.rb
 - lib/canopus/plugins.rb
 - lib/canopus/plugins/api.rb
+- lib/canopus/plugins/host.rb
 - lib/canopus/plugins/isolated_runtime.rb
 - lib/canopus/plugins/local_runtime.rb
 - lib/canopus/plugins/permission_denied.rb
 - lib/canopus/plugins/registry.rb
+- lib/canopus/plugins/vocabulary.rb
 - lib/canopus/project.rb
 - lib/canopus/project/tree.rb
 - lib/canopus/project/watcher.rb

data/docs/release-log.md

@@ -1,17 +0,0 @@
-# Dependency Release Log
-
-| Date | Repository | Version | Canopus follow-up | Reason |
-| --- | --- | --- | --- | --- |
-| 2026-09-18 | kochab | 0.2.0 | 2026-09-18 | Settings schema metadata and safe layer merge API |
-| 2026-09-18 | tarazed | 0.2.4 | 2026-09-18 | Explicit command-history clearing for terminal consumers |
-| 2026-09-18 | tarazed | 0.2.3 | 2026-09-18 | Shell executable detection for argument-bearing and Windows commands |
-| 2026-09-17 | thuban | 0.6.0 | 2026-09-17 | Transactional merge-conflict snapshots and resolution |
-| 2026-09-17 | thuban | 0.5.0 | 2026-09-17 | Atomic partial staging and managed Git transfers |
-| 2026-09-17 | thuban | 0.4.1 | 2026-09-17 | Lazy remote provider loading for headless startup |
-| 2026-09-17 | tarazed | 0.2.2 | 2026-09-17 | Drain final Windows ConPTY output after process exit |
-| 2026-09-16 | megrez | 0.1.1 | 2026-09-16 | Debug Adapter Protocol session lifecycle |
-| 2026-09-16 | antares | 0.2.1 | 2026-09-16 | CRLF-safe selection range columns |
-| 2026-09-16 | denebola | 0.2.1 | 2026-09-16 | Deterministic same-offset edit and anchor mapping |
-| 2026-09-15 | thuban | 0.4.0 | 2026-09-17 | Git write, commit, history, stash, and remote APIs |
-| 2026-09-15 | porrima | 0.2.0 | 2026-09-17 | Structured three-way merge conflict resolution |
-| 2026-09-14 | thuban | 0.2.0 | 2026-09-14 | Public `IgnoreMatcher` API |