kward 0.83.0 → 0.84.0

data/templates/default/fulldoc/html/images/kward_workflow.svg

@@ -0,0 +1,52 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="700" viewBox="0 0 1200 700" role="img" aria-labelledby="title description">
+  <title id="title">Kward coding workflow</title>
+  <desc id="description">A Kward terminal session reads and edits the CLI, runs focused tests, and reports a successful authentication error-handling change.</desc>
+  <defs>
+    <linearGradient id="background" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#11170f"/>
+      <stop offset="1" stop-color="#070b07"/>
+    </linearGradient>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="18" stdDeviation="22" flood-color="#000" flood-opacity=".45"/>
+    </filter>
+  </defs>
+  <rect width="1200" height="700" fill="#070b07"/>
+  <rect x="28" y="28" width="1144" height="644" rx="20" fill="url(#background)" stroke="#465035" stroke-width="2" filter="url(#shadow)"/>
+  <path d="M28 82h1144" stroke="#293024" stroke-width="2"/>
+  <circle cx="62" cy="55" r="8" fill="#ff5f57"/>
+  <circle cx="88" cy="55" r="8" fill="#febc2e"/>
+  <circle cx="114" cy="55" r="8" fill="#28c840"/>
+  <text x="600" y="63" text-anchor="middle" fill="#777c68" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="18">kward · ~/code/kward</text>
+
+  <g font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace">
+    <circle cx="65" cy="119" r="7" fill="#9caf35"/>
+    <text x="84" y="126" fill="#efe8d0" font-size="20" font-weight="700">Kward v0.83.0 is online.</text>
+    <text x="64" y="159" fill="#777c68" font-size="16">Workspace</text>
+    <text x="180" y="159" fill="#d2df62" font-size="16">kaiwood/kward</text>
+    <text x="64" y="184" fill="#777c68" font-size="16">Branch</text>
+    <text x="180" y="184" fill="#d2df62" font-size="16">main</text>
+    <text x="64" y="219" fill="#efe8d0" font-size="18" font-weight="700">State your business.</text>
+
+    <text x="64" y="276" fill="#afa88f" font-size="16" font-weight="700">You&gt;</text>
+    <text x="126" y="276" fill="#efe8d0" font-size="18">Make one-shot authentication failures concise and add focused tests.</text>
+
+    <rect x="64" y="309" width="1072" height="164" rx="12" fill="#0d120d" stroke="#293024"/>
+    <text x="88" y="342" fill="#9caf35" font-size="15" font-weight="700">TOOL ACTIVITY</text>
+    <text x="88" y="378" fill="#d2df62" font-size="17">Read</text>
+    <text x="174" y="378" fill="#efe8d0" font-size="17">lib/kward/cli.rb</text>
+    <text x="88" y="414" fill="#d2df62" font-size="17">Edit</text>
+    <text x="174" y="414" fill="#efe8d0" font-size="17">lib/kward/cli.rb</text>
+    <text x="1016" y="414" text-anchor="end" fill="#9caf35" font-size="16">+34</text>
+    <text x="88" y="450" fill="#d2df62" font-size="17">Test</text>
+    <text x="174" y="450" fill="#efe8d0" font-size="17">3 runs · 26 assertions</text>
+    <text x="1110" y="450" text-anchor="end" fill="#9caf35" font-size="17" font-weight="700">0 failures</text>
+
+    <text x="64" y="526" fill="#9caf35" font-size="16" font-weight="700">Kward&gt;</text>
+    <text x="154" y="526" fill="#efe8d0" font-size="18">Authentication failures now return an actionable message without a traceback.</text>
+    <text x="154" y="559" fill="#afa88f" font-size="17">Debug backtraces remain available with KWARD_DEBUG=1.</text>
+
+    <path d="M52 608h1096" stroke="#293024"/>
+    <text x="64" y="642" fill="#afa88f" font-size="15">main*</text>
+    <text x="1128" y="642" text-anchor="end" fill="#777c68" font-size="15">18% · Codex gpt-5.6-sol · medium</text>
+  </g>
+</svg>

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

@@ -9,7 +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))
+  asset('images/kward_workflow.svg', file('images/kward_workflow.svg', true))
 end
 
 def stylesheets_full_list

data/templates/default/kward_navigation.rb

@@ -12,6 +12,7 @@ module KwardDocsNavigationData
         ["Authentication", "file.authentication.html"],
         ["Model providers", "file.providers.html"],
         ["Security and trust", "file.security.html"],
+        ["Platform support", "file.platform-support.html"],
         ["Troubleshooting", "file.troubleshooting.html"]
       ]
     ],

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

@@ -0,0 +1,10 @@
+<div id="footer">
+  <% if home_page? %>
+    Kward is open source software released under the
+    <a href="https://github.com/kaiwood/kward/blob/main/LICENSE">MIT License</a>.
+  <% else %>
+    Generated with
+    <a href="https://yardoc.org" title="YARD documentation tool" target="_parent">YARD</a>
+    <%= YARD::VERSION %>.
+  <% end %>
+</div>

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

@@ -0,0 +1,23 @@
+<meta charset="<%= charset %>">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title><%= h docs_page_title %></title>
+<meta name="description" content="<%= h docs_page_description %>">
+<meta name="theme-color" content="#070b07">
+<link rel="canonical" href="<%= h docs_canonical_url %>">
+<link rel="icon" type="image/png" href="<%= url_for('images/kward_logo.png') %>">
+<meta property="og:type" content="website">
+<meta property="og:site_name" content="Kward">
+<meta property="og:title" content="<%= h docs_page_title %>">
+<meta property="og:description" content="<%= h docs_page_description %>">
+<meta property="og:url" content="<%= h docs_canonical_url %>">
+<meta property="og:image" content="https://kaiwood.github.io/kward/images/kward_logo.png">
+<meta name="twitter:card" content="summary">
+<meta name="twitter:title" content="<%= h docs_page_title %>">
+<meta name="twitter:description" content="<%= h docs_page_description %>">
+<% stylesheets.each do |stylesheet| %>
+  <link rel="stylesheet" href="<%= mtime_url(stylesheet) %>" type="text/css">
+<% end %>
+<%= erb :script_setup %>
+<% javascripts.each do |javascript| %>
+  <script type="text/javascript" charset="utf-8" src="<%= mtime_url(javascript) %>"></script>
+<% end %>

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

@@ -80,23 +80,11 @@
       <main id="main" class="kward-home">
         <section class="kward-hero">
           <div class="kward-hero-copy">
-            <p class="kward-eyebrow">⌘ Ruby CLI Coding Agent</p>
-            <h1>
-              <span class="kward-swosh" aria-label="Your terminal. Your RPC frontend. Your workflow.">
-                <span class="kward-swosh-text kward-swosh-text-a" aria-hidden="true">Your terminal.</span>
-                <span class="kward-swosh-text kward-swosh-text-b" aria-hidden="true">Your RPC frontend.</span>
-                <span class="kward-swosh-text kward-swosh-text-e" aria-hidden="true">Your workflow.</span>
-              </span>
-              <br>
-              <span class="kward-swosh" aria-label="Your agent. Your LLM engine. Your harness.">
-                <span class="kward-swosh-text kward-swosh-text-c" aria-hidden="true">Your agent.</span>
-                <span class="kward-swosh-text kward-swosh-text-d" aria-hidden="true">Your LLM engine.</span>
-                <span class="kward-swosh-text kward-swosh-text-f" aria-hidden="true">Your harness.</span>
-              </span>
-            </h1>
-            <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>
+            <p class="kward-eyebrow">⌘ Ruby-native coding agent</p>
+            <h1>A coding agent that works <span>where you do.</span></h1>
+            <p class="kward-lede">Inspect code, edit files, run tests, and resume work from your terminal—with your choice of model provider.</p>
             <div class="kward-actions">
-              <a class="kward-primary-button" href="<%= url_for('file.README.html') %>">Get Started ›</a>
+              <a class="kward-primary-button" href="<%= url_for('file.getting-started.html') %>">Get Started ›</a>
               <a class="kward-secondary-button" href="https://github.com/kaiwood/kward" target="_blank" rel="noopener noreferrer">View on GitHub</a>
             </div>
             <p class="kward-supports">Supports <span>OpenAI</span>, <span>Anthropic</span>, <span>OpenRouter</span> &amp; more.</p>
@@ -110,7 +98,7 @@
           <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>Builtin shell and editor</h2><p>Run commands and edit files safely in the workspace.</p></article>
+          <article><strong>⌗</strong><h2>Built-in shell and editor</h2><p>Run commands and edit files safely in the workspace.</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>
@@ -125,7 +113,7 @@
             <a href="<%= url_for('file.getting-started.html') %>">View full installation docs →</a>
           </div>
           <div class="kward-screen-card">
-            <img src="<%= url_for('images/kward_screen_1.png') %>" alt="Kward terminal interface screenshot">
+            <img src="<%= url_for('images/kward_workflow.svg') %>" alt="Kward completing a focused coding change and test run">
           </div>
         </section>
 

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

@@ -24,16 +24,23 @@ module KwardDocsNavigation
       end
     end
   ].freeze
+  DOCS_LINK_TITLES = (
+    [["Overview", GUIDE_OVERVIEW], ["Advanced", EXTENSION_OVERVIEW], ["API Docs", API_OVERVIEW]] +
+    (GUIDE_GROUPS + EXTENSION_GROUPS + API_GROUPS).flat_map { |_title, items| items }
+  ).to_h { |label, link| [link, label] }.freeze
   GUIDE_FILE_LINKS = {
     "doc/getting-started.md" => "file.getting-started.html",
     "doc/usage.md" => "file.usage.html",
     "doc/configuration.md" => "file.configuration.html",
     "doc/authentication.md" => "file.authentication.html",
     "doc/providers.md" => "file.providers.html",
+    "doc/security.md" => "file.security.html",
+    "doc/platform-support.md" => "file.platform-support.html",
     "doc/permissions.md" => "file.permissions.html",
     "doc/sandboxing.md" => "file.sandboxing.html",
     "doc/troubleshooting.md" => "file.troubleshooting.html",
     "doc/session-management.md" => "file.session-management.html",
+    "doc/composer.md" => "file.composer.html",
     "doc/tabs.md" => "file.tabs.html",
     "doc/files.md" => "file.files.html",
     "doc/editor.md" => "file.editor.html",
@@ -42,6 +49,9 @@ module KwardDocsNavigation
     "doc/memory.md" => "file.memory.html",
     "doc/personas.md" => "file.personas.html",
     "doc/skills.md" => "file.skills.html",
+    "doc/prompt-templates.md" => "file.prompt-templates.html",
+    "doc/pan.md" => "file.pan.html",
+    "doc/mcp.md" => "file.mcp.html",
     "doc/local-models.md" => "file.local-models.html",
     "doc/extensibility.md" => "file.extensibility.html",
     "doc/plugins.md" => "file.plugins.html",
@@ -79,7 +89,7 @@ module KwardDocsNavigation
         title: title,
         path: source,
         url: url_for(link),
-        text: content.gsub(/[`*_#>\[\]()]/, " ").gsub(/\s+/, " ").strip
+        text: content.gsub(/<[^>]+>/, " ").gsub(/[`*_#>\[\]()]/, " ").gsub(/\s+/, " ").strip
       }
     end
   end
@@ -111,6 +121,35 @@ module KwardDocsNavigation
     options.index && readme_file?
   end
 
+  def docs_page_title
+    return "Kward — Ruby Coding Agent for Your Terminal" if home_page?
+
+    page = DOCS_LINK_TITLES[docs_output_path] || @page_title.to_s.sub(/\AFile:\s*/, "")
+    "#{page} | Kward Docs"
+  end
+
+  def docs_page_description
+    if home_page?
+      "Kward is an extensible Ruby coding agent for inspecting code, editing files, running tests, and resuming work from your terminal."
+    else
+      "Documentation for Kward, the extensible Ruby coding agent for your terminal."
+    end
+  end
+
+  def docs_canonical_url
+    return "https://kaiwood.github.io/kward/" if home_page?
+
+    "https://kaiwood.github.io/kward/#{docs_output_path}"
+  end
+
+  def docs_output_path
+    if defined?(@file) && @file
+      GUIDE_FILE_LINKS[@file.filename.to_s] || API_FILE_LINKS[@file.filename.to_s] || current_docs_path
+    else
+      current_docs_path
+    end
+  end
+
   def guide_page?
     (readme_file? && !options.index) || guide_file? || GUIDE_LINKS.include?(current_docs_path)
   end
@@ -133,7 +172,7 @@ module KwardDocsNavigation
     GUIDE_FILE_LINKS.merge(API_FILE_LINKS).each do |source, target|
       html = html.gsub(%(href="#{source}"), %(href="#{target}"))
     end
-    html
+    html.gsub(%(src="templates/default/fulldoc/html/images/), %(src="images/))
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kward
 version: !ruby/object:Gem::Version
-  version: 0.83.0
+  version: 0.84.0
 platform: ruby
 authors:
 - Kai Wood
@@ -107,8 +107,22 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Kward is a Ruby CLI coding agent with local workspace tools, configurable
-  prompts, web search, sessions, and an experimental JSON-RPC backend.
+- !ruby/object:Gem::Dependency
+  name: unicode-display_width
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Kward is an extensible Ruby coding agent with workspace tools, resumable
+  sessions, multiple model providers, a local browser UI, and JSON-RPC integrations.
 email:
 - kai.wood@icloud.com
 executables:
@@ -118,11 +132,13 @@ extra_rdoc_files: []
 files:
 - ".yardopts"
 - CHANGELOG.md
+- CONTRIBUTING.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
 - README.md
 - Rakefile
+- SECURITY.md
 - doc/agent-tools.md
 - doc/api.md
 - doc/authentication.md
@@ -143,6 +159,7 @@ files:
 - doc/pan.md
 - doc/permissions.md
 - doc/personas.md
+- doc/platform-support.md
 - doc/plugins.md
 - doc/prompt-templates.md
 - doc/providers.md
@@ -213,11 +230,11 @@ files:
 - lib/kward/context_budget_meter.rb
 - lib/kward/conversation.rb
 - lib/kward/deep_copy.rb
+- lib/kward/detached_run.rb
 - lib/kward/diff_view_mode.rb
 - lib/kward/editor_mode.rb
 - lib/kward/editor_prompt.rb
 - lib/kward/editor_prompt_session.rb
-- lib/kward/ekwsh.rb
 - lib/kward/events.rb
 - lib/kward/export_path.rb
 - lib/kward/frontmatter.rb
@@ -235,8 +252,11 @@ files:
 - lib/kward/http.rb
 - lib/kward/image_attachments.rb
 - lib/kward/interactive_pty_runner.rb
+- lib/kward/kwsh.rb
+- lib/kward/kwshrc.rb
 - lib/kward/local_command_runner.rb
 - lib/kward/local_pty_command_runner.rb
+- lib/kward/markdown_code_block.rb
 - lib/kward/markdown_transcript.rb
 - lib/kward/mcp/client.rb
 - lib/kward/mcp/server_config.rb
@@ -289,6 +309,8 @@ files:
 - 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/runner.rb
+- lib/kward/prompt_interface/editor/runner_state.rb
 - lib/kward/prompt_interface/editor/search.rb
 - lib/kward/prompt_interface/editor/selections.rb
 - lib/kward/prompt_interface/editor/state.rb
@@ -350,6 +372,7 @@ files:
 - lib/kward/sandbox/policy.rb
 - lib/kward/sandbox/runner_factory.rb
 - lib/kward/sandbox/unavailable_runner.rb
+- lib/kward/scratchpad_languages.rb
 - lib/kward/scratchpad_runner.rb
 - lib/kward/session_catalog.rb
 - lib/kward/session_diff.rb
@@ -374,7 +397,9 @@ files:
 - lib/kward/terminal_image_support.rb
 - lib/kward/terminal_keys.rb
 - lib/kward/terminal_sequences.rb
+- lib/kward/terminal_text.rb
 - lib/kward/text_boundary.rb
+- lib/kward/text_matcher.rb
 - lib/kward/tool_output_compactor.rb
 - lib/kward/tools/ask_user_question.rb
 - lib/kward/tools/base.rb
@@ -387,6 +412,7 @@ files:
 - lib/kward/tools/git_commit.rb
 - lib/kward/tools/list_directory.rb
 - lib/kward/tools/mcp_tool.rb
+- lib/kward/tools/open_editor.rb
 - lib/kward/tools/prepare_shell_command.rb
 - lib/kward/tools/read_file.rb
 - lib/kward/tools/read_skill.rb
@@ -417,21 +443,23 @@ 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/images/kward_workflow.svg
 - templates/default/fulldoc/html/js/kward.js
 - templates/default/fulldoc/html/setup.rb
 - templates/default/kward_navigation.rb
 - templates/default/layout/html/breadcrumb.erb
+- templates/default/layout/html/footer.erb
+- templates/default/layout/html/headers.erb
 - templates/default/layout/html/layout.erb
 - templates/default/layout/html/setup.rb
-homepage: https://github.com/kaiwood/kward
+homepage: https://kaiwood.github.io/kward/
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/kaiwood/kward
   changelog_uri: https://github.com/kaiwood/kward/blob/main/CHANGELOG.md
-  documentation_uri: https://github.com/kaiwood/kward#readme
+  documentation_uri: https://kaiwood.github.io/kward/
   bug_tracker_uri: https://github.com/kaiwood/kward/issues
 rdoc_options: []
 require_paths:
@@ -449,5 +477,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: An extendable Ruby CLI coding agent.
+summary: An extensible Ruby coding agent for your terminal.
 test_files: []