kward 0.73.1 → 0.75.0

data/lib/kward/update_check.rb

@@ -0,0 +1,117 @@
+require "fileutils"
+require "json"
+require "net/http"
+require "time"
+require "uri"
+
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  # Cached RubyGems update check for the interactive startup screen.
+  class UpdateCheck
+    CHECK_INTERVAL_SECONDS = 24 * 60 * 60
+    LATEST_VERSION_URL = URI("https://rubygems.org/api/v1/versions/kward/latest.json")
+
+    Notice = Struct.new(:latest_version, keyword_init: true)
+
+    def initialize(current_version:, config: ConfigFiles.read_config, path: ConfigFiles.update_check_cache_path, now: Time.now)
+      @current_version = current_version.to_s
+      @config = config
+      @path = path
+      @now = now
+    end
+
+    def enabled?
+      return false if disabled_by_environment?
+
+      updates = @config["updates"]
+      return false if updates.is_a?(Hash) && updates["check"] == false
+
+      true
+    end
+
+    def notice
+      return nil unless enabled?
+
+      latest_version = cache["latest_version"].to_s
+      return nil if latest_version.empty?
+      return nil if dismissed_version == latest_version
+      return nil unless newer_than_current?(latest_version)
+
+      Notice.new(latest_version: latest_version)
+    end
+
+    def refresh_if_stale
+      return false unless enabled?
+      return false unless stale?
+
+      refresh
+    end
+
+    def refresh
+      latest_version = fetch_latest_version
+      write_cache(cache.merge(
+        "checked_at" => @now.utc.iso8601,
+        "latest_version" => latest_version
+      ))
+      true
+    rescue StandardError
+      false
+    end
+
+    private
+
+    def disabled_by_environment?
+      value = ENV["KWARD_DISABLE_UPDATE_CHECK"].to_s.strip.downcase
+      ["1", "true", "yes", "on"].include?(value)
+    end
+
+    def dismissed_version
+      cache["dismissed_version"].to_s
+    end
+
+    def stale?
+      checked_at = Time.iso8601(cache["checked_at"].to_s)
+      (@now - checked_at) >= CHECK_INTERVAL_SECONDS
+    rescue ArgumentError, TypeError
+      true
+    end
+
+    def cache
+      @cache ||= read_cache
+    end
+
+    def read_cache
+      return {} unless File.file?(@path)
+
+      data = JSON.parse(File.read(@path))
+      data.is_a?(Hash) ? data : {}
+    rescue JSON::ParserError, SystemCallError
+      {}
+    end
+
+    def write_cache(data)
+      FileUtils.mkdir_p(File.dirname(@path))
+      File.write(@path, JSON.pretty_generate(data) + "\n")
+      @cache = data
+    end
+
+    def fetch_latest_version
+      request = Net::HTTP::Get.new(LATEST_VERSION_URL)
+      request["User-Agent"] = "kward/#{Kward::VERSION}"
+      response = Net::HTTP.start(LATEST_VERSION_URL.hostname, LATEST_VERSION_URL.port, use_ssl: true, open_timeout: 2, read_timeout: 2) do |http|
+        http.request(request)
+      end
+      return "" unless response.is_a?(Net::HTTPSuccess)
+
+      JSON.parse(response.body)["version"].to_s
+    rescue JSON::ParserError
+      ""
+    end
+
+    def newer_than_current?(version)
+      Gem::Version.new(version) > Gem::Version.new(@current_version)
+    rescue ArgumentError
+      false
+    end
+  end
+end

data/lib/kward/version.rb

@@ -1,5 +1,5 @@
 # Namespace for the Kward CLI agent runtime.
 module Kward
   # Current gem version.
-  VERSION = "0.73.1"
+  VERSION = "0.75.0"
 end

data/lib/kward/workers/manager.rb

@@ -2,6 +2,7 @@ require "timeout"
 require_relative "../agent"
 require_relative "../cancellation"
 require_relative "../conversation"
+require_relative "../hooks"
 require_relative "../model/client"
 require_relative "../session_store"
 require_relative "../tools/registry"
@@ -16,7 +17,7 @@ module Kward
     class Manager
       DEFAULT_TIMEOUT_SECONDS = 180
 
-      def initialize(client_factory: -> { Client.new }, prompt: nil, workspace_root: Dir.pwd, timeout_seconds: DEFAULT_TIMEOUT_SECONDS, on_status_change: nil, session_store: nil, provider: nil, model: nil, reasoning_effort: nil, write_lock: nil, worker_store: nil, git_guard: nil, write_lane_available: -> { true })
+      def initialize(client_factory: -> { Client.new }, prompt: nil, workspace_root: Dir.pwd, timeout_seconds: DEFAULT_TIMEOUT_SECONDS, on_status_change: nil, session_store: nil, provider: nil, model: nil, reasoning_effort: nil, write_lock: nil, worker_store: nil, git_guard: nil, write_lane_available: -> { true }, hook_manager: nil, hook_context: nil)
         @client_factory = client_factory
         @prompt = prompt
         @workspace_root = ConfigFiles.canonical_workspace_root(workspace_root)
@@ -30,12 +31,15 @@ module Kward
         @worker_store = worker_store
         @git_guard = git_guard || GitGuard.new(root: @workspace_root)
         @write_lane_available = write_lane_available
+        @hook_manager = hook_manager
+        @hook_context = hook_context
         @workers = {}
         @mutex = Mutex.new
       end
 
       def start(role:, prompt:, title: nil, id: nil)
         worker = build_worker(role: role, prompt: prompt, title: title, id: id)
+        run_blocking_hook("worker_job_create", worker)
         enqueue(worker)
       end
 
@@ -105,15 +109,19 @@ module Kward
         worker.conversation = conversation
         attach_session(worker, conversation)
         writer_id = wait_for_worker_writer(worker)
+        run_blocking_hook("worker_job_start_before", worker)
         update_status(worker, "running")
+        run_hook("worker_job_start_after", worker)
         registry = ToolRegistry.new(
           workspace: Workspace.new(root: worker.workspace_root),
           prompt: @prompt,
           allowed_tool_names: ToolPolicy.allowed_tool_names(worker.role),
           write_lock: @write_lock,
-          writer_id: writer_id
+          writer_id: writer_id,
+          hook_manager: @hook_manager,
+          hook_context: @hook_context
         )
-        agent = Agent.new(client: @client_factory.call, tool_registry: registry, conversation: conversation)
+        agent = Agent.new(client: @client_factory.call, tool_registry: registry, conversation: conversation, hook_manager: @hook_manager, hook_context: @hook_context)
         report = Timeout.timeout(@timeout_seconds, WorkerTimeoutError) do
           agent.ask(worker_prompt(worker), cancellation: worker.cancellation) do |event|
             worker.record_event(event)
@@ -121,16 +129,48 @@ module Kward
         end
         report = finalize_write_worker(worker, report)
         update_status(worker, "ready", report: report, error: "")
+        run_hook("worker_job_ready_for_review", worker)
       rescue WorkerTimeoutError
         update_status(worker, "failed", error: "Worker timed out after #{@timeout_seconds} seconds")
+        run_hook("worker_job_failed", worker, error: "Worker timed out after #{@timeout_seconds} seconds")
       rescue Cancellation::CancelledError
         update_status(worker, "cancelled")
       rescue StandardError => e
         update_status(worker, "failed", error: e.message)
+        run_hook("worker_job_failed", worker, error: e.message)
       ensure
         release_worker_writer(worker)
       end
 
+      def run_blocking_hook(name, worker, payload = {})
+        result = run_hook(name, worker, payload)
+        return result unless result && !result.allowed?
+
+        raise HookDenied, result.decision.message || "Worker lifecycle hook #{name} blocked the job"
+      end
+
+      def run_hook(name, worker, payload = {})
+        return unless @hook_manager
+
+        @hook_manager.run(Hooks::Event.new(
+          name: name,
+          workspace: { root: worker.workspace_root },
+          payload: worker_payload(worker).merge(payload)
+        ), context: @hook_context)
+      end
+
+      HookDenied = Class.new(StandardError)
+
+      def worker_payload(worker)
+        {
+          worker_id: worker.id,
+          role: worker.role,
+          title: worker.title,
+          status: worker.status,
+          session_path: worker.session&.path
+        }.compact
+      end
+
       def update_status(worker, status, **values)
         return worker if worker.status == "archived" && status.to_s != "archived"
 

data/lib/kward/workspace.rb

@@ -2,6 +2,8 @@ require "pathname"
 require_relative "local_command_runner"
 require_relative "session_diff"
 
+require_relative "path_guard"
+
 # Namespace for the Kward CLI agent runtime.
 module Kward
   # Filesystem and shell-command boundary for workspace tools.
@@ -212,7 +214,7 @@ module Kward
     end
 
     def inside_workspace?(path)
-      path.to_s == @root.to_s || path.to_s.start_with?("#{@root}/")
+      PathGuard.inside?(path, @root)
     end
 
     def relative_path(path)

data/templates/default/fulldoc/html/css/kward.css

@@ -1030,6 +1030,21 @@ body.kward-docs .kward-home #footer p {
 }
 
 @media (max-width: 620px) {
+  .kward-hero > *,
+  .kward-install-card > *,
+  .kward-feature-strip > *,
+  .kward-capabilities li {
+    min-width: 0;
+  }
+
+  .kward-hero h1 {
+    font-size: clamp(32px, 10vw, 38px);
+  }
+
+  .kward-swosh {
+    max-width: 100%;
+  }
+
   .kward-feature-strip,
   .kward-capabilities ul {
     grid-template-columns: 1fr;
@@ -1370,6 +1385,7 @@ body.kward-docs .kward-home #footer {
     flex-direction: column;
     gap: 2px;
     height: auto !important;
+    justify-content: flex-start;
     left: 12px;
     max-height: calc(100vh - 100px);
     overflow-y: auto;
@@ -1810,6 +1826,12 @@ body.kward-docs #toc li > ol {
   margin-top: 6px;
 }
 
+body.kward-docs #content code,
+body.kward-docs #filecontents code,
+body.kward-docs #toc code {
+  overflow-wrap: anywhere;
+}
+
 
 /* Keep TOC hover states readable on the dark theme. */
 body.kward-docs #toc a:hover,

data/templates/default/fulldoc/html/js/kward.js

@@ -8,8 +8,10 @@ const guideLinks = {
   'doc/session-management.md': 'file.session-management.html',
   'doc/memory.md': 'file.memory.html',
   'doc/personas.md': 'file.personas.html',
+  'doc/skills.md': 'file.skills.html',
   'doc/extensibility.md': 'file.extensibility.html',
   'doc/plugins.md': 'file.plugins.html',
+  'doc/lifecycle-hooks.md': 'file.lifecycle-hooks.html',
   'doc/agent-tools.md': 'file.agent-tools.html',
   'doc/workspace-tools.md': 'file.workspace-tools.html',
   'doc/web-search.md': 'file.web-search.html',

data/templates/default/kward_navigation.rb

@@ -18,7 +18,8 @@ module KwardDocsNavigationData
         ["Sessions", "file.session-management.html"],
         ["Tabs", "file.tabs.html"],
         ["Memory", "file.memory.html"],
-        ["Personas", "file.personas.html"]
+        ["Personas", "file.personas.html"],
+        ["Skills", "file.skills.html"]
       ]
     ],
     [
@@ -37,7 +38,8 @@ module KwardDocsNavigationData
       "Customize",
       [
         ["Extensibility", "file.extensibility.html"],
-        ["Plugins", "file.plugins.html"]
+        ["Plugins", "file.plugins.html"],
+        ["Lifecycle hooks", "file.lifecycle-hooks.html"]
       ]
     ],
     [

data/templates/default/layout/html/setup.rb

@@ -38,8 +38,10 @@ module KwardDocsNavigation
     "doc/shell.md" => "file.shell.html",
     "doc/memory.md" => "file.memory.html",
     "doc/personas.md" => "file.personas.html",
+    "doc/skills.md" => "file.skills.html",
     "doc/extensibility.md" => "file.extensibility.html",
     "doc/plugins.md" => "file.plugins.html",
+    "doc/lifecycle-hooks.md" => "file.lifecycle-hooks.html",
     "doc/agent-tools.md" => "file.agent-tools.html",
     "doc/workspace-tools.md" => "file.workspace-tools.html",
     "doc/context-budgeting.md" => "file.context-budgeting.html",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kward
 version: !ruby/object:Gem::Version
-  version: 0.73.1
+  version: 0.75.0
 platform: ruby
 authors:
 - Kai Wood
@@ -137,6 +137,8 @@ files:
 - doc/files.md
 - doc/getting-started.md
 - doc/git.md
+- doc/lifecycle-hooks.md
+- doc/mcp.md
 - doc/memory.md
 - doc/personas.md
 - doc/plugins.md
@@ -144,6 +146,7 @@ files:
 - doc/rpc.md
 - doc/session-management.md
 - doc/shell.md
+- doc/skills.md
 - doc/tabs.md
 - doc/troubleshooting.md
 - doc/usage.md
@@ -158,6 +161,7 @@ files:
 - lib/kward/auth/anthropic_oauth.rb
 - lib/kward/auth/file.rb
 - lib/kward/auth/github_oauth.rb
+- lib/kward/auth/oauth_helpers.rb
 - lib/kward/auth/openai_oauth.rb
 - lib/kward/auth/openrouter_api_key.rb
 - lib/kward/cancellation.rb
@@ -167,6 +171,7 @@ files:
 - lib/kward/cli/compaction.rb
 - lib/kward/cli/doctor.rb
 - lib/kward/cli/git.rb
+- lib/kward/cli/hook_commands.rb
 - lib/kward/cli/interactive_turn.rb
 - lib/kward/cli/memory_commands.rb
 - lib/kward/cli/openrouter_commands.rb
@@ -184,26 +189,45 @@ files:
 - lib/kward/cli_transcript_formatter.rb
 - lib/kward/clipboard.rb
 - lib/kward/compaction/file_operation_tracker.rb
+- lib/kward/compaction/token_estimator.rb
 - lib/kward/compactor.rb
 - lib/kward/config_files.rb
 - lib/kward/context_budget_meter.rb
 - lib/kward/conversation.rb
+- lib/kward/deep_copy.rb
+- lib/kward/diff_view_mode.rb
 - lib/kward/editor_mode.rb
 - lib/kward/ekwsh.rb
 - lib/kward/events.rb
 - lib/kward/export_path.rb
+- lib/kward/frontmatter.rb
+- lib/kward/hooks.rb
+- lib/kward/hooks/audit_log.rb
+- lib/kward/hooks/catalog.rb
+- lib/kward/hooks/command_handler.rb
+- lib/kward/hooks/config_loader.rb
+- lib/kward/hooks/decision.rb
+- lib/kward/hooks/event.rb
+- lib/kward/hooks/http_handler.rb
+- lib/kward/hooks/manager.rb
+- lib/kward/hooks/matcher.rb
 - lib/kward/image_attachments.rb
 - lib/kward/interactive_pty_runner.rb
 - lib/kward/local_command_runner.rb
 - lib/kward/local_pty_command_runner.rb
 - lib/kward/markdown_transcript.rb
+- lib/kward/mcp/client.rb
+- lib/kward/mcp/server_config.rb
+- lib/kward/mcp/stdio_transport.rb
 - lib/kward/memory/manager.rb
+- lib/kward/memory/turn_context.rb
 - lib/kward/message_access.rb
 - lib/kward/message_text.rb
 - lib/kward/model/chat_invocation.rb
 - lib/kward/model/client.rb
 - lib/kward/model/context_overflow.rb
 - lib/kward/model/context_usage.rb
+- lib/kward/model/copilot_models.rb
 - lib/kward/model/model_info.rb
 - lib/kward/model/payloads.rb
 - lib/kward/model/retry_message.rb
@@ -211,6 +235,7 @@ files:
 - lib/kward/openrouter_model_cache.rb
 - lib/kward/pan/index.html.erb
 - lib/kward/pan/server.rb
+- lib/kward/path_guard.rb
 - lib/kward/plugin_registry.rb
 - lib/kward/private_file.rb
 - lib/kward/project_files.rb
@@ -265,6 +290,7 @@ files:
 - lib/kward/rpc/attachment_normalizer.rb
 - lib/kward/rpc/auth_manager.rb
 - lib/kward/rpc/config_manager.rb
+- lib/kward/rpc/mcp_status.rb
 - lib/kward/rpc/memory_methods.rb
 - lib/kward/rpc/prompt_bridge.rb
 - lib/kward/rpc/redactor.rb
@@ -278,6 +304,7 @@ files:
 - lib/kward/rpc/tool_metadata.rb
 - lib/kward/rpc/transcript_normalizer.rb
 - lib/kward/rpc/transport.rb
+- lib/kward/rpc/turn_context.rb
 - lib/kward/scratchpad_runner.rb
 - lib/kward/session_diff.rb
 - lib/kward/session_naming.rb
@@ -305,6 +332,7 @@ files:
 - lib/kward/tools/fetch_content.rb
 - lib/kward/tools/fetch_raw.rb
 - lib/kward/tools/list_directory.rb
+- lib/kward/tools/mcp_tool.rb
 - lib/kward/tools/read_file.rb
 - lib/kward/tools/read_skill.rb
 - lib/kward/tools/registry.rb
@@ -318,6 +346,7 @@ files:
 - lib/kward/tools/web_search.rb
 - lib/kward/tools/write_file.rb
 - lib/kward/transcript_export.rb
+- lib/kward/update_check.rb
 - lib/kward/version.rb
 - lib/kward/workers.rb
 - lib/kward/workers/git_guard.rb