kward 0.72.0 → 0.73.0

data/lib/kward/workspace.rb

@@ -1,6 +1,5 @@
-require "open3"
 require "pathname"
-require "timeout"
+require_relative "local_command_runner"
 require_relative "session_diff"
 
 # Namespace for the Kward CLI agent runtime.
@@ -23,6 +22,7 @@ module Kward
     MAX_COMMAND_OUTPUT_BYTES = 128 * 1024
     MAX_EDIT_DIFF_BYTES = 8 * 1024
     DEFAULT_COMMAND_TIMEOUT_SECONDS = 30
+    EXPECTED_FILE_ERRORS = [SecurityError, Errno::ENOENT, Errno::EACCES, Errno::EPERM, Errno::EISDIR, Errno::ENOTDIR].freeze
 
     # Creates an object for workspace filesystem and shell operations.
     def initialize(root: Dir.pwd, max_file_bytes: MAX_FILE_BYTES, max_read_output_bytes: MAX_READ_OUTPUT_BYTES, max_read_output_lines: MAX_READ_OUTPUT_LINES, max_command_output_bytes: MAX_COMMAND_OUTPUT_BYTES, guardrails: true)
@@ -45,7 +45,7 @@ module Kward
       Dir.children(resolved).sort.map do |entry|
         File.directory?(File.join(resolved, entry)) ? "#{entry}/" : entry
       end.join("\n")
-    rescue SecurityError, Errno::ENOENT => e
+    rescue *EXPECTED_FILE_ERRORS => e
       "Error: #{e.message}"
     end
 
@@ -82,7 +82,7 @@ module Kward
       else
         large_file_outline_response(path, content, offset: offset, limit: limit) || read_file_slice(content, offset: offset, limit: limit, max_bytes: output_budget)
       end
-    rescue SecurityError, Errno::ENOENT => e
+    rescue *EXPECTED_FILE_ERRORS => e
       "Error: #{e.message}"
     end
 
@@ -98,7 +98,7 @@ module Kward
       return "Error: not a text file: #{path}" if binary_content?(content)
 
       file_structure_summary(path, content)
-    rescue SecurityError, Errno::ENOENT => e
+    rescue *EXPECTED_FILE_ERRORS => e
       "Error: #{e.message}"
     end
 
@@ -120,7 +120,7 @@ module Kward
       output = "Wrote #{content.bytesize} bytes to #{path}"
       output << "\n#{truncated_diff(path, old_content, content)}" if old_content && old_content != content
       output
-    rescue SecurityError, Errno::ENOENT => e
+    rescue *EXPECTED_FILE_ERRORS => e
       "Error: #{e.message}"
     end
 
@@ -143,7 +143,7 @@ module Kward
 
       File.write(resolved, result[:content])
       "Edited #{path}: replaced #{result[:count]} block(s)\n#{truncated_diff(path, content, result[:content])}"
-    rescue SecurityError, Errno::ENOENT => e
+    rescue *EXPECTED_FILE_ERRORS => e
       "Error: #{e.message}"
     end
 
@@ -160,24 +160,14 @@ module Kward
       timeout_seconds = DEFAULT_COMMAND_TIMEOUT_SECONDS if timeout_seconds <= 0
       cancellation&.raise_if_cancelled!
 
-      Open3.popen3(command, chdir: @root.to_s) do |stdin, stdout, stderr, wait_thread|
-        stdin.close
-        stdout_reader = Thread.new { stdout.read }
-        stderr_reader = Thread.new { stderr.read }
-        cancellation&.on_cancel { terminate_process(wait_thread.pid) }
-        status = wait_for_process(wait_thread, timeout_seconds, cancellation)
-
-        output = +"Exit status: #{status.exitstatus}\n"
-        output << "\nSTDOUT:\n#{stdout_reader.value}" unless stdout_reader.value.empty?
-        output << "\nSTDERR:\n#{stderr_reader.value}" unless stderr_reader.value.empty?
-        truncate_output(output)
-      rescue Timeout::Error
-        terminate_process(wait_thread.pid)
-        "Error: command timed out after #{timeout_seconds} seconds"
-      ensure
-        stdout_reader&.kill if stdout_reader&.alive?
-        stderr_reader&.kill if stderr_reader&.alive?
-      end
+      result = LocalCommandRunner.new(timeout_seconds: timeout_seconds, max_output_bytes: @max_command_output_bytes).run(command, cwd: @root.to_s, cancellation: cancellation)
+      return "Error: command timed out after #{timeout_seconds} seconds" if result.timed_out
+
+      output = +"Exit status: #{result.exit_status}\n"
+      output << "\nSTDOUT:\n#{result.stdout}" unless result.stdout.empty?
+      output << "\nSTDERR:\n#{result.stderr}" unless result.stderr.empty?
+      output << "\n... truncated to #{@max_command_output_bytes} bytes" if result.truncated
+      truncate_output(output)
     rescue Errno::ENOENT, ArgumentError => e
       "Error: #{e.message}"
     end
@@ -522,43 +512,5 @@ module Kward
       output.byteslice(0, @max_command_output_bytes) << "\n... truncated to #{@max_command_output_bytes} bytes"
     end
 
-    def wait_for_process(wait_thread, timeout_seconds, cancellation)
-      deadline = Time.now + timeout_seconds
-      loop do
-        cancellation&.raise_if_cancelled!
-        if wait_thread.join(0.05)
-          cancellation&.raise_if_cancelled!
-          return wait_thread.value
-        end
-        raise Timeout::Error if Time.now >= deadline
-      end
-    end
-
-    def terminate_process(pid)
-      return unless signal_process("TERM", pid)
-
-      deadline = Time.now + 0.2
-      while Time.now < deadline
-        return unless process_running?(pid)
-
-        sleep 0.02
-      end
-
-      signal_process("KILL", pid)
-    end
-
-    def process_running?(pid)
-      Process.kill(0, pid)
-      true
-    rescue Errno::ESRCH
-      false
-    end
-
-    def signal_process(signal, pid)
-      Process.kill(signal, pid)
-      true
-    rescue Errno::ESRCH
-      false
-    end
   end
 end

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

@@ -879,6 +879,39 @@ body.kward-docs #footer {
   margin: 0;
 }
 
+.kward-screen-card {
+  align-self: center;
+  background: linear-gradient(180deg, rgba(31, 38, 27, 0.98), rgba(5, 8, 5, 0.98));
+  border: 1px solid rgba(156, 175, 53, 0.42);
+  border-radius: 14px;
+  box-shadow: 0 24px 70px rgba(0, 0, 0, 0.34);
+  box-sizing: border-box;
+  max-width: 100%;
+  overflow: hidden;
+  padding-top: 34px;
+  position: relative;
+}
+
+.kward-screen-card::before {
+  background:
+    radial-gradient(circle at 12px 50%, #ff5f57 0 5px, transparent 5.5px),
+    radial-gradient(circle at 32px 50%, #febc2e 0 5px, transparent 5.5px),
+    radial-gradient(circle at 52px 50%, #28c840 0 5px, transparent 5.5px);
+  border-bottom: 1px solid rgba(149, 169, 52, 0.22);
+  content: "";
+  height: 34px;
+  left: 0;
+  position: absolute;
+  right: 0;
+  top: 0;
+}
+
+.kward-screen-card img {
+  display: block;
+  height: auto;
+  max-width: 100%;
+}
+
 .kward-capabilities {
   padding: 28px;
 }

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

@@ -9,6 +9,7 @@ def generate_assets
   asset('css/kward.css', file('css/kward.css', true))
   asset('js/kward.js', file('js/kward.js', true))
   asset('images/kward_logo.png', file('images/kward_logo.png', true))
+  asset('images/kward_screen_1.png', file('images/kward_screen_1.png', true))
 end
 
 def stylesheets_full_list

data/templates/default/layout/html/layout.erb

@@ -94,7 +94,7 @@
                 <span class="kward-swosh-text kward-swosh-text-f" aria-hidden="true">Your harness.</span>
               </span>
             </h1>
-            <p class="kward-lede">Kward is an extendable Ruby CLI coding agent that helps you understand your project, edit files, run commands, search the web, and automate workflows—right from your terminal.</p>
+            <p class="kward-lede">Kward is a general-purpose coding agent written in Ruby: terminal-native, project-aware, pipeable, and designed around your workflow.</p>
             <div class="kward-actions">
               <a class="kward-primary-button" href="<%= url_for('file.README.html') %>">Get Started ›</a>
               <a class="kward-secondary-button" href="https://github.com/kaiwood/kward" target="_blank" rel="noopener noreferrer">View on GitHub</a>
@@ -107,12 +107,12 @@
         </section>
 
         <section id="features" class="kward-feature-strip" aria-label="Feature summary">
-          <article><strong>☏</strong><h2>Chat in your terminal</h2><p>Multi-turn coding conversations.</p></article>
-          <article><strong>▤</strong><h2>Read, write, edit files</h2><p>With read-before-write guardrails.</p></article>
-          <article><strong>›_</strong><h2>Run shell commands</h2><p>Execute local commands safely.</p></article>
-          <article><strong>◎</strong><h2>Search the web</h2><p>Get live answers and inspect repos.</p></article>
-          <article><strong>✣</strong><h2>Extend with plugins</h2><p>Trusted Ruby plugins for workflows.</p></article>
-          <article><strong>▰</strong><h2>Sessions &amp; memory</h2><p>Save, resume, clone, compact, export.</p></article>
+          <article><strong>⌘</strong><h2>Project-aware agent loop</h2><p>Inspect, reason, patch, verify.</p></article>
+          <article><strong>▤</strong><h2>Unix filter mode</h2><p>Pipe diffs, logs, and code through Kward.</p></article>
+          <article><strong>▰</strong><h2>Branchable sessions</h2><p>Resume, rewind, fork, compact, export.</p></article>
+          <article><strong>›_</strong><h2>Worker pipelines</h2><p>Queue focused agent tasks from the TUI.</p></article>
+          <article><strong>◎</strong><h2>Live source intelligence</h2><p>Search the web and read public repos.</p></article>
+          <article><strong>✣</strong><h2>Ruby-native extensions</h2><p>Shape Kward with plugins, skills, and prompts.</p></article>
         </section>
 
         <section class="kward-install-card">
@@ -124,36 +124,23 @@
             <pre><code>kward init</code></pre>
             <a href="<%= url_for('file.getting-started.html') %>">View full installation docs →</a>
           </div>
-          <div class="kward-terminal-card">
-            <div class="kward-tabs"><span>Quick Start</span><span>Run from Source</span></div>
-            <pre><code># Start an interactive chat
-kward
-
-# Show available commands and examples
-kward help
-
-# Sign in or save provider credentials
-kward login
-
-# Run one prompt and exit
-kward "Explain this project"
-
-# Use a specific working directory
-kward --working-directory ~/code/project "Explain this project"</code></pre>
+          <div class="kward-screen-card">
+            <img src="<%= url_for('images/kward_screen_1.png') %>" alt="Kward terminal interface screenshot">
           </div>
         </section>
 
         <section class="kward-capabilities">
-          <h2>⌘ What Kward can do</h2>
+          <h2>⌘ Built for real development loops</h2>
           <ul>
-            <li>Keep a multi-turn coding conversation in your terminal.</li>
-            <li>Read, write, and edit workspace files with read-before-write guardrails.</li>
-            <li>Run local shell commands from the workspace.</li>
-            <li>Search the live web and inspect cached public GitHub repositories.</li>
-            <li>Save, resume, clone, compact, and export sessions.</li>
-            <li>Use optional memory, personas, prompt templates, and skills.</li>
-            <li>Extend the Agent with trusted Ruby plugins for custom workflows.</li>
-            <li>Serve an experimental JSON-RPC backend for UI clients.</li>
+            <li>Inspect, patch, verify, repeat against a real workspace.</li>
+            <li>Edit files in Kward’s built-in editor with syntax highlighting, search, undo, and familiar keybindings.</li>
+            <li>Review diffs, stage files, and commit changes from the integrated Git workflow.</li>
+            <li>Pipe diffs, logs, code, and generated text through Kward as a Unix filter.</li>
+            <li>Organize long-running work with tabs, sessions, rewind, forks, compaction, and exports.</li>
+            <li>Dispatch worker tasks, leave them running, review the results later.</li>
+            <li>Ground answers with live web search and public source repositories before guessing.</li>
+            <li>Shape Kward with memory, skills, prompts, personas, and trusted Ruby plugins.</li>
+            <li>Build custom UIs on top of Kward’s JSON-RPC backend.</li>
           </ul>
         </section>
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kward
 version: !ruby/object:Gem::Version
-  version: 0.72.0
+  version: 0.73.0
 platform: ruby
 authors:
 - Kai Wood
@@ -116,6 +116,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".github/workflows/pages.yml"
 - ".yardopts"
 - CHANGELOG.md
@@ -192,6 +193,9 @@ files:
 - lib/kward/events.rb
 - lib/kward/export_path.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/memory/manager.rb
 - lib/kward/message_access.rb
@@ -227,6 +231,7 @@ files:
 - lib/kward/prompt_interface/editor/modes/emacs.rb
 - lib/kward/prompt_interface/editor/modes/modern.rb
 - lib/kward/prompt_interface/editor/modes/vibe.rb
+- lib/kward/prompt_interface/editor/modes/vibe_insert_readline.rb
 - lib/kward/prompt_interface/editor/renderer.rb
 - lib/kward/prompt_interface/editor/search.rb
 - lib/kward/prompt_interface/editor/selections.rb
@@ -260,6 +265,7 @@ files:
 - lib/kward/rpc/attachment_normalizer.rb
 - lib/kward/rpc/auth_manager.rb
 - lib/kward/rpc/config_manager.rb
+- lib/kward/rpc/memory_methods.rb
 - lib/kward/rpc/prompt_bridge.rb
 - lib/kward/rpc/redactor.rb
 - lib/kward/rpc/runtime_payloads.rb
@@ -272,7 +278,9 @@ files:
 - lib/kward/rpc/tool_metadata.rb
 - lib/kward/rpc/transcript_normalizer.rb
 - lib/kward/rpc/transport.rb
+- lib/kward/scratchpad_runner.rb
 - lib/kward/session_diff.rb
+- lib/kward/session_naming.rb
 - lib/kward/session_store.rb
 - lib/kward/session_trash.rb
 - lib/kward/session_tree_nodes.rb
@@ -284,6 +292,8 @@ files:
 - lib/kward/tab_store.rb
 - lib/kward/telemetry/logger.rb
 - lib/kward/telemetry/stats.rb
+- lib/kward/terminal_keys.rb
+- lib/kward/terminal_sequences.rb
 - lib/kward/text_boundary.rb
 - lib/kward/tool_output_compactor.rb
 - lib/kward/tools/ask_user_question.rb
@@ -311,8 +321,11 @@ files:
 - lib/kward/version.rb
 - lib/kward/workers.rb
 - lib/kward/workers/git_guard.rb
+- lib/kward/workers/job.rb
 - lib/kward/workers/live_view.rb
 - lib/kward/workers/manager.rb
+- lib/kward/workers/queue_runner.rb
+- lib/kward/workers/queue_store.rb
 - lib/kward/workers/store.rb
 - lib/kward/workers/tool_policy.rb
 - lib/kward/workers/worker.rb
@@ -322,6 +335,7 @@ files:
 - templates/default/fulldoc/html/css/kward.css
 - templates/default/fulldoc/html/full_list.erb
 - templates/default/fulldoc/html/images/kward_logo.png
+- templates/default/fulldoc/html/images/kward_screen_1.png
 - templates/default/fulldoc/html/js/kward.js
 - templates/default/fulldoc/html/setup.rb
 - templates/default/kward_navigation.rb