kward 0.71.0 → 0.72.0

data/lib/kward/workers/worker.rb

@@ -0,0 +1,82 @@
+require "securerandom"
+require "time"
+require_relative "../config_files"
+require_relative "../cancellation"
+
+module Kward
+  module Workers
+    # Runtime record for one independent unit of agent work.
+    class Worker
+      STATUSES = %w[idle queued running ready failed cancelled archived].freeze
+
+      def initialize(id: SecureRandom.hex(4), title:, role:, workspace_root: Dir.pwd, status: "idle", prompt: nil, conversation: nil, session: nil, cancellation: Cancellation.new, created_at: Time.now.utc)
+        @id = id
+        @title = title.to_s
+        @role = role.to_s
+        @workspace_root = ConfigFiles.canonical_workspace_root(workspace_root)
+        @status = status.to_s
+        @prompt = prompt.to_s
+        @conversation = conversation
+        @session = session
+        @cancellation = cancellation
+        @created_at = created_at
+        @updated_at = created_at
+        @started_at = nil
+        @finished_at = nil
+        @report = nil
+        @error = nil
+        @thread = nil
+        @event_history = []
+        @event_queue = Queue.new
+      end
+
+      attr_reader :id, :title, :role, :workspace_root, :prompt, :conversation, :session, :cancellation, :created_at, :updated_at, :started_at, :finished_at, :report, :error, :thread, :event_history, :event_queue
+      attr_writer :conversation, :session, :thread
+
+      def status
+        @status
+      end
+
+      def update_status(status, error: nil, report: nil)
+        @status = status.to_s
+        @error = error unless error.nil?
+        @report = report unless report.nil?
+        now = Time.now.utc
+        @updated_at = now
+        @started_at ||= now if @status == "running"
+        @finished_at = now if %w[ready failed cancelled archived].include?(@status)
+        self
+      end
+
+      def record_event(event)
+        @event_history << event
+        @event_queue << event
+      end
+
+      def to_h
+        {
+          "id" => id,
+          "title" => title,
+          "role" => role,
+          "status" => status,
+          "prompt" => prompt,
+          "workspace_root" => workspace_root,
+          "session_id" => session&.id,
+          "session_path" => session&.path,
+          "created_at" => timestamp(created_at),
+          "updated_at" => timestamp(updated_at),
+          "started_at" => timestamp(started_at),
+          "finished_at" => timestamp(finished_at),
+          "report" => report,
+          "error" => error
+        }
+      end
+
+      private
+
+      def timestamp(value)
+        value&.utc&.iso8601(3)
+      end
+    end
+  end
+end

data/lib/kward/workers/write_lock.rb

@@ -0,0 +1,38 @@
+require "thread"
+
+module Kward
+  module Workers
+    # Cooperative ownership guard for workspace-mutating worker tools.
+    class WriteLock
+      def initialize
+        @owner_id = nil
+        @mutex = Mutex.new
+      end
+
+      attr_reader :owner_id
+
+      def acquire(owner_id)
+        owner = owner_id.to_s
+        return false if owner.empty?
+
+        @mutex.synchronize do
+          return true if @owner_id == owner
+          return false if @owner_id
+
+          @owner_id = owner
+          true
+        end
+      end
+
+      def owned_by?(owner_id)
+        @mutex.synchronize { @owner_id == owner_id.to_s }
+      end
+
+      def release(owner_id)
+        @mutex.synchronize do
+          @owner_id = nil if @owner_id == owner_id.to_s
+        end
+      end
+    end
+  end
+end

data/lib/kward/workers.rb

@@ -0,0 +1,7 @@
+require_relative "workers/git_guard"
+require_relative "workers/live_view"
+require_relative "workers/manager"
+require_relative "workers/store"
+require_relative "workers/tool_policy"
+require_relative "workers/write_lock"
+require_relative "workers/worker"

data/lib/kward/workspace.rb

@@ -54,7 +54,7 @@ module Kward
     # The returned string is user/model-facing and includes continuation notices
     # when output is truncated. Errors are returned as `"Error: ..."` strings so
     # tool calls can be persisted in the conversation without raising.
-    def read_file(path, offset: nil, limit: nil)
+    def read_file(path, offset: nil, limit: nil, mode: nil, max_bytes: nil)
       resolved = workspace_path(path)
       return "Error: not a file: #{path}" unless File.file?(resolved)
 
@@ -64,7 +64,24 @@ module Kward
       content = File.read(resolved)
       return "Error: not a text file: #{path}" if binary_content?(content)
 
-      large_file_outline_response(path, content, offset: offset, limit: limit) || read_file_slice(content, offset: offset, limit: limit)
+      read_mode = normalize_read_mode(mode)
+      return read_mode if read_mode.is_a?(String)
+
+      output_budget = read_output_budget(max_bytes)
+      return output_budget if output_budget.is_a?(String)
+
+      case read_mode
+      when :outline
+        file_structure_summary(path, content)
+      when :preview
+        read_file_slice(content, offset: offset, limit: limit || 120, max_bytes: output_budget)
+      when :range
+        read_file_slice(content, offset: offset, limit: limit, max_bytes: output_budget)
+      when :full
+        read_file_slice(content, offset: offset, limit: limit, max_bytes: output_budget)
+      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
       "Error: #{e.message}"
     end
@@ -80,11 +97,7 @@ module Kward
       content = File.read(resolved)
       return "Error: not a text file: #{path}" if binary_content?(content)
 
-      lines = content.split("\n", -1)
-      outline = source_outline(lines)
-      return "No recognizable source structure found in #{path}." if outline.empty?
-
-      (["# File structure: #{path}", "- Lines: #{lines.length}", "- Bytes: #{content.bytesize}", "", "## Outline"] + outline).join("\n")
+      file_structure_summary(path, content)
     rescue SecurityError, Errno::ENOENT => e
       "Error: #{e.message}"
     end
@@ -235,24 +248,96 @@ module Kward
         "First #{preview_limit} lines:",
         preview,
         "",
-        "[Use read_file with offset=#{preview_limit + 1} and limit to continue, or request a specific section from the outline.]"
+        "[Use read_file with mode=\"range\", offset=#{preview_limit + 1}, and limit to continue; mode=\"outline\" for only the outline; or request a specific section from the outline.]"
       ].join("\n")
     end
 
+    def file_structure_summary(path, content)
+      lines = content.split("\n", -1)
+      outline = source_outline(lines)
+      return "No recognizable source structure found in #{path}." if outline.empty?
+
+      (["# File structure: #{path}", "- Lines: #{lines.length}", "- Bytes: #{content.bytesize}", "", "## Outline"] + outline).join("\n")
+    end
+
     def source_outline(lines)
-      outline = []
+      entries = source_outline_entries(lines)
+      entries.first(80).map do |entry|
+        range = entry[:end_line] && entry[:end_line] != entry[:line] ? " (range #{entry[:line]}-#{entry[:end_line]}, #{entry[:kind]})" : " (#{entry[:kind]})"
+        "line #{entry[:line]}: #{'  ' * [entry[:indent] / 2, 6].min}#{entry[:signature]}#{range}"
+      end
+    end
+
+    def source_outline_entries(lines)
+      candidates = []
       lines.each_with_index do |line, index|
-        stripped = line.strip
-        next unless stripped.match?(/\A(class|module|def)\s+/) || stripped.match?(/\A(function|async function)\s+/) || stripped.match?(/\A(export\s+)?(class|interface|type)\s+/)
+        declaration = source_declaration(line.strip)
+        next unless declaration
+
+        candidates << declaration.merge(line: index + 1, indent: line[/\A\s*/].to_s.length)
+      end
+      candidates.each_with_index do |entry, index|
+        following = candidates[(index + 1)..]&.find { |candidate| candidate[:indent] <= entry[:indent] }
+        entry[:end_line] = following ? following[:line] - 1 : last_content_line(lines)
+      end
+      candidates
+    end
 
-        indent = line[/\A\s*/].to_s.length
-        outline << "line #{index + 1}: #{'  ' * [indent / 2, 6].min}#{stripped}"
-        break if outline.length >= 80
+    def source_declaration(stripped)
+      case stripped
+      when /\A(module)\s+(.+)/
+        { kind: "module", signature: stripped }
+      when /\A(class)\s+(.+)/
+        { kind: "class", signature: stripped }
+      when /\A(async\s+def|def)\s+(.+)/
+        { kind: "function", signature: stripped }
+      when /\A(export\s+)?(async\s+)?function\s+(.+)/
+        { kind: "function", signature: stripped }
+      when /\A(async\s+)?(?:get\s+|set\s+)?(?:constructor|[A-Za-z_$][\w$]*)\s*\([^;]*\)\s*(?::\s*[^{}]+)?\s*(?:\{\}|\{|=>)?\z/
+        { kind: "method", signature: stripped } unless stripped.match?(/\A(if|for|while|switch|catch)\b/)
+      when /\A(export\s+)?(class|interface|type|enum)\s+(.+)/
+        { kind: Regexp.last_match(2), signature: stripped }
+      when /\A(?:export\s+)?(?:const|let|var)\s+\w+\s*=.*=>/
+        { kind: "function", signature: stripped }
+      when /\Afunc\s+(.+)/
+        { kind: "function", signature: stripped }
+      when /\Atype\s+\w+\s+(struct|interface)\b/
+        { kind: Regexp.last_match(1), signature: stripped }
+      when /\A(pub\s+)?(async\s+)?fn\s+(.+)/
+        { kind: "function", signature: stripped }
+      when /\A(pub\s+)?(struct|enum|trait|impl)\b(.+)?/
+        { kind: Regexp.last_match(2), signature: stripped }
+      when /\A(?:public|private|protected|internal|static|final|abstract|async|override|virtual|sealed|readonly|partial|\s)+\s*(class|interface|enum|record)\s+(.+)/
+        { kind: Regexp.last_match(1), signature: stripped }
+      when /\A(?:public|private|protected|internal|static|final|abstract|async|override|virtual|sealed|readonly|partial|\s)+\s*\S[^{;=]*\w+\s*\([^;]*\)\s*(?:\{|=>)?\z/
+        { kind: "method", signature: stripped }
       end
-      outline
     end
 
-    def read_file_slice(content, offset:, limit:)
+    def last_content_line(lines)
+      index = lines.rindex { |line| !line.strip.empty? }
+      index ? index + 1 : lines.length
+    end
+
+    def normalize_read_mode(mode)
+      return nil if mode.nil? || mode.to_s.empty?
+
+      value = mode.to_s.downcase
+      return value.to_sym if %w[preview outline range full].include?(value)
+
+      "Error: mode must be one of preview, outline, range, full"
+    end
+
+    def read_output_budget(max_bytes)
+      return @max_read_output_bytes if max_bytes.nil?
+
+      value = max_bytes.to_i
+      return "Error: max_bytes must be positive" unless value.positive?
+
+      [value, @max_read_output_bytes].min
+    end
+
+    def read_file_slice(content, offset:, limit:, max_bytes: @max_read_output_bytes)
       lines = content.split("\n", -1)
       lines = [""] if lines.empty?
       start_index = read_start_index(offset)
@@ -263,7 +348,7 @@ module Kward
 
       selected_end = user_limit ? [start_index + user_limit, lines.length].min : lines.length
       selected_lines = lines[start_index...selected_end]
-      truncated = truncate_read_lines(selected_lines)
+      truncated = truncate_read_lines(selected_lines, max_bytes: max_bytes)
       return truncated[:error] if truncated[:error]
 
       output = truncated[:content]
@@ -272,7 +357,8 @@ module Kward
           start_index: start_index,
           output_lines: truncated[:line_count],
           total_lines: lines.length,
-          truncated_by: truncated[:truncated_by]
+          truncated_by: truncated[:truncated_by],
+          max_bytes: max_bytes
         )
       elsif user_limit && selected_end < lines.length
         output << "\n\n[#{lines.length - selected_end} more lines in file. Use offset=#{selected_end + 1} to continue.]"
@@ -300,11 +386,11 @@ module Kward
       value
     end
 
-    def truncate_read_lines(lines)
+    def truncate_read_lines(lines, max_bytes: @max_read_output_bytes)
       first_line = lines.first.to_s
-      if first_line.bytesize > @max_read_output_bytes
+      if first_line.bytesize > max_bytes
         return {
-          error: "Error: first line is #{first_line.bytesize} bytes, exceeds #{@max_read_output_bytes} byte read limit. Use run_shell_command with sed/head to inspect smaller chunks."
+          error: "Error: first line is #{first_line.bytesize} bytes, exceeds #{max_bytes} byte read limit. Use run_shell_command with sed/head to inspect smaller chunks."
         }
       end
 
@@ -319,7 +405,7 @@ module Kward
 
         separator_bytes = output_lines.empty? ? 0 : 1
         next_bytes = line.bytesize + separator_bytes
-        if bytes + next_bytes > @max_read_output_bytes
+        if bytes + next_bytes > max_bytes
           truncated_by = "bytes"
           break
         end
@@ -336,10 +422,10 @@ module Kward
       }
     end
 
-    def read_truncation_notice(start_index:, output_lines:, total_lines:, truncated_by:)
+    def read_truncation_notice(start_index:, output_lines:, total_lines:, truncated_by:, max_bytes: @max_read_output_bytes)
       end_line = start_index + output_lines
       next_offset = end_line + 1
-      detail = truncated_by == "lines" ? "#{@max_read_output_lines} line limit" : "#{@max_read_output_bytes} byte limit"
+      detail = truncated_by == "lines" ? "#{@max_read_output_lines} line limit" : "#{max_bytes} byte limit"
       "\n\n[Showing lines #{start_index + 1}-#{end_line} of #{total_lines} (#{detail}). Use offset=#{next_offset} to continue.]"
     end
 

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

@@ -341,7 +341,41 @@ body.kward-docs a {
   color: var(--kward-accent-bright);
 }
 
-body.kward-docs pre {
+body.kward-docs #content quote,
+body.kward-docs #filecontents quote {
+  border-left: 3px solid var(--kward-accent);
+  color: var(--kward-ink);
+  display: block;
+  font-style: italic;
+  font-size: 18px;
+  line-height: 1.8;
+  margin: 28px 0;
+  padding: 8px 0 8px 46px;
+  position: relative;
+}
+
+body.kward-docs #content quote::before,
+body.kward-docs #filecontents quote::before {
+  color: var(--kward-accent);
+  content: "\201C";
+  font-family: Georgia, "Times New Roman", serif;
+  font-size: 80px;
+  font-style: normal;
+  left: 4px;
+  line-height: 1;
+  opacity: 0.55;
+  position: absolute;
+  top: -10px;
+}
+
+body.kward-docs #content quote br,
+body.kward-docs #filecontents quote br {
+  content: "";
+  display: block;
+  margin-bottom: 4px;
+}
+
+body.kward-docs #content pre {
   background: var(--kward-code);
   border: 1px solid rgba(149, 169, 52, 0.22);
   border-radius: 10px;
@@ -537,11 +571,10 @@ body.kward-docs #footer {
 }
 
 /*
-  Hero tagline "swosh": "Your terminal." flies out to the left and is
-  replaced by "Your RPC frontend." flying in from the right, then cycles
-  back. The second line mirrors it from the opposite side — "Your agent."
-  flies out to the right and is replaced by "Your engine." flying in from
-  the left — both lines swap in sync. Pure CSS — no JS. The global
+  Hero tagline "swosh": cycles each line through three phrases. The first
+  line moves right-to-left: "Your terminal.", "Your RPC frontend.", then
+  "Your workflow." The second line mirrors it left-to-right: "Your agent.",
+  "Your LLM engine.", then "Your harness." Pure CSS — no JS. The global
   @media (prefers-reduced-motion) rule above collapses the animation to
   the static original copy ("Your terminal. Your agent.") so it remains
   accessible and calm.
@@ -566,68 +599,95 @@ body.kward-docs #footer {
   will-change: transform, opacity;
 }
 
-/* The longer text ("Your RPC frontend.") stays in flow to size the box;
-   the shorter "Your terminal." overlays it absolutely. */
-.kward-swosh-text-a {
+/* The longest text ("Your RPC frontend.") stays in flow to size the box;
+   the shorter phrases overlay it absolutely. */
+.kward-swosh-text-a,
+.kward-swosh-text-e {
   left: 0.08em;
   position: absolute;
   top: 0.16em;
 }
 
 .kward-swosh-text-a {
-  animation: kward-swosh-a 12s cubic-bezier(0.22, 0.61, 0.36, 1) infinite;
+  animation: kward-swosh-a 18s cubic-bezier(0.22, 0.61, 0.36, 1) infinite;
 }
 
 .kward-swosh-text-b {
-  animation: kward-swosh-b 12s cubic-bezier(0.22, 0.61, 0.36, 1) infinite;
+  animation: kward-swosh-b 18s cubic-bezier(0.22, 0.61, 0.36, 1) infinite;
   position: relative;
 }
 
+.kward-swosh-text-e {
+  animation: kward-swosh-e 18s cubic-bezier(0.22, 0.61, 0.36, 1) infinite;
+}
+
 @keyframes kward-swosh-a {
-  0%, 40%   { transform: translateX(0);     opacity: 1; filter: none; }
-  50%       { transform: translateX(-140%); opacity: 0; filter: blur(3px); }
-  51%, 88%  { transform: translateX(140%);  opacity: 0; filter: none; }
+  0%, 25%   { transform: translateX(0);     opacity: 1; filter: none; }
+  33%       { transform: translateX(-140%); opacity: 0; filter: blur(3px); }
+  34%, 92%  { transform: translateX(140%);  opacity: 0; filter: none; }
   100%      { transform: translateX(0);     opacity: 1; filter: none; }
 }
 
 @keyframes kward-swosh-b {
-  0%, 40%   { transform: translateX(140%);  opacity: 0; filter: none; }
-  50%       { transform: translateX(0);     opacity: 1; filter: none; }
-  88%       { transform: translateX(0);     opacity: 1; filter: none; }
+  0%, 25%   { transform: translateX(140%);  opacity: 0; filter: none; }
+  33%       { transform: translateX(0);     opacity: 1; filter: none; }
+  58%       { transform: translateX(0);     opacity: 1; filter: none; }
+  66%       { transform: translateX(-140%); opacity: 0; filter: blur(3px); }
+  67%, 100% { transform: translateX(140%);  opacity: 0; filter: none; }
+}
+
+@keyframes kward-swosh-e {
+  0%, 58%   { transform: translateX(140%);  opacity: 0; filter: none; }
+  66%       { transform: translateX(0);     opacity: 1; filter: none; }
+  92%       { transform: translateX(0);     opacity: 1; filter: none; }
   100%      { transform: translateX(-140%); opacity: 0; filter: blur(3px); }
 }
 
 /*
-  Second line, mirrored: "Your agent." exits to the right while
-  "Your LLM engine." enters from the left (left-to-right), in sync with
-  the first swosh. Both texts keep the accent-bright color of the
-  original "Your agent." span.
+  Second line, mirrored left-to-right. All texts keep the accent-bright
+  color of the original "Your agent." span.
 */
-.kward-hero h1 .kward-swosh-text-c {
-  animation: kward-swosh-c 12s cubic-bezier(0.22, 0.61, 0.36, 1) infinite;
+.kward-hero h1 .kward-swosh-text-c,
+.kward-hero h1 .kward-swosh-text-f {
   color: var(--kward-accent-bright);
   left: 0.08em;
   position: absolute;
   top: 0.16em;
 }
 
+.kward-hero h1 .kward-swosh-text-c {
+  animation: kward-swosh-c 18s cubic-bezier(0.22, 0.61, 0.36, 1) infinite;
+}
+
 .kward-hero h1 .kward-swosh-text-d {
-  animation: kward-swosh-d 12s cubic-bezier(0.22, 0.61, 0.36, 1) infinite;
+  animation: kward-swosh-d 18s cubic-bezier(0.22, 0.61, 0.36, 1) infinite;
   color: var(--kward-accent-bright);
   position: relative;
 }
 
+.kward-hero h1 .kward-swosh-text-f {
+  animation: kward-swosh-f 18s cubic-bezier(0.22, 0.61, 0.36, 1) infinite;
+}
+
 @keyframes kward-swosh-c {
-  0%, 40%  { transform: translateX(0);     opacity: 1; filter: none; }
-  50%       { transform: translateX(140%);  opacity: 0; filter: blur(3px); }
-  51%, 88%  { transform: translateX(-140%); opacity: 0; filter: none; }
+  0%, 25%   { transform: translateX(0);     opacity: 1; filter: none; }
+  33%       { transform: translateX(140%);  opacity: 0; filter: blur(3px); }
+  34%, 92%  { transform: translateX(-140%); opacity: 0; filter: none; }
   100%      { transform: translateX(0);     opacity: 1; filter: none; }
 }
 
 @keyframes kward-swosh-d {
-  0%, 40%  { transform: translateX(-140%); opacity: 0; filter: none; }
-  50%       { transform: translateX(0);     opacity: 1; filter: none; }
-  88%       { transform: translateX(0);     opacity: 1; filter: none; }
+  0%, 25%   { transform: translateX(-140%); opacity: 0; filter: none; }
+  33%       { transform: translateX(0);     opacity: 1; filter: none; }
+  58%       { transform: translateX(0);     opacity: 1; filter: none; }
+  66%       { transform: translateX(140%);  opacity: 0; filter: blur(3px); }
+  67%, 100% { transform: translateX(-140%); opacity: 0; filter: none; }
+}
+
+@keyframes kward-swosh-f {
+  0%, 58%   { transform: translateX(-140%); opacity: 0; filter: none; }
+  66%       { transform: translateX(0);     opacity: 1; filter: none; }
+  92%       { transform: translateX(0);     opacity: 1; filter: none; }
   100%      { transform: translateX(140%);  opacity: 0; filter: blur(3px); }
 }
 
@@ -1193,7 +1253,7 @@ body.kward-docs .kward-home #footer {
   box-shadow: 0 24px 70px rgba(0, 0, 0, 0.48);
   display: none;
   gap: 16px;
-  grid-template-columns: repeat(2, minmax(160px, 220px));
+  grid-template-columns: repeat(3, minmax(160px, 220px));
   left: 50%;
   max-width: calc(100vw - 48px);
   opacity: 0;
@@ -1549,17 +1609,14 @@ body.kward-docs #main.kward-home {
   justify-content: center;
 }
 
-/* The generated YARD TOC is useful for API pages but too noisy on guide pages. */
-.kward-guide-page #toc {
-  display: none;
-}
+/* The generated YARD TOC is shown on all docs pages. Use the `kward-no-toc` marker to suppress it per page. */
 
 
 /* Code blocks own their copy action. */
 body.kward-docs .code-copy-wrapper {
+  display: flow-root;
   margin: 16px 0 24px;
   position: relative;
-  width: 100%;
 }
 
 body.kward-docs .code-copy-wrapper pre,
@@ -1571,11 +1628,14 @@ body.kward-docs .code-copy-wrapper pre.code {
 }
 
 body.kward-docs .code-copy-wrapper .copy-code-button {
+  background: #020503;
+  box-shadow: 0 0 0 4px #020503;
   float: none;
   margin: 0;
   position: absolute;
   right: 12px;
   top: 12px;
+  z-index: 2;
 }
 
 
@@ -1986,6 +2046,17 @@ body.kward-docs ul.toplevel a:active {
     color: #000;
   }
 
+  body.kward-docs #content quote,
+  body.kward-docs #filecontents quote {
+    border-left-color: #999;
+    color: #000;
+  }
+
+  body.kward-docs #content quote::before,
+  body.kward-docs #filecontents quote::before {
+    color: #999;
+  }
+
   .kward-page {
     padding: 0;
     max-width: none;

data/templates/default/kward_navigation.rb

@@ -16,9 +16,19 @@ module KwardDocsNavigationData
       "Feature guides",
       [
         ["Sessions", "file.session-management.html"],
+        ["Tabs", "file.tabs.html"],
         ["Memory", "file.memory.html"],
         ["Personas", "file.personas.html"]
       ]
+    ],
+    [
+      "User Tools",
+      [
+        ["Project files", "file.files.html"],
+        ["Integrated Editor", "file.editor.html"],
+        ["Git", "file.git.html"],
+        ["Shell", "file.shell.html"]
+      ]
     ]
   ].freeze
 
@@ -44,7 +54,8 @@ module KwardDocsNavigationData
         ["Workspace tools", "file.workspace-tools.html"],
         ["Web search", "file.web-search.html"],
         ["Code search", "file.code-search.html"],
-        ["Context tools", "file.context-tools.html"]
+        ["Context tools", "file.context-tools.html"],
+        ["Context budgeting", "file.context-budgeting.html"]
       ]
     ]
   ].freeze

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

@@ -82,14 +82,16 @@
           <div class="kward-hero-copy">
             <p class="kward-eyebrow">⌘ Ruby CLI Coding Agent</p>
             <h1>
-              <span class="kward-swosh" aria-label="Your terminal.">
+              <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.">
+              <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 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>

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

@@ -31,12 +31,18 @@ module KwardDocsNavigation
     "doc/authentication.md" => "file.authentication.html",
     "doc/troubleshooting.md" => "file.troubleshooting.html",
     "doc/session-management.md" => "file.session-management.html",
+    "doc/tabs.md" => "file.tabs.html",
+    "doc/files.md" => "file.files.html",
+    "doc/editor.md" => "file.editor.html",
+    "doc/git.md" => "file.git.html",
+    "doc/shell.md" => "file.shell.html",
     "doc/memory.md" => "file.memory.html",
     "doc/personas.md" => "file.personas.html",
     "doc/extensibility.md" => "file.extensibility.html",
     "doc/plugins.md" => "file.plugins.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",
     "doc/web-search.md" => "file.web-search.html",
     "doc/code-search.md" => "file.code-search.html",
     "doc/context-tools.md" => "file.context-tools.html",