kward 0.82.0 → 0.84.0

data/lib/kward/tools/registry.rb

@@ -14,10 +14,13 @@ require_relative "mcp_tool"
 require_relative "read_file"
 require_relative "read_skill"
 require_relative "run_shell_command"
+require_relative "prepare_shell_command"
 require_relative "summarize_file_structure"
 require_relative "retrieve_tool_output"
 require_relative "web_search"
 require_relative "write_file"
+require_relative "open_editor"
+require_relative "replace_editor_buffer"
 require_relative "search/code"
 require_relative "search/web"
 require_relative "search/web_fetch"
@@ -71,15 +74,15 @@ module Kward
     # Builds tool objects and the schema list for the current frontend/config.
     #
     # @param workspace [Workspace] filesystem/shell boundary used by local tools
-    # @param prompt [Object, nil] interactive prompt bridge; must implement
-    #   `ask_user_question` before that tool is advertised
+    # @param prompt [Object, nil] interactive prompt bridge; tools such as
+    #   `ask_user_question` and `open_editor` are advertised only when supported
     # @param web_search [WebSearch] live web search implementation
     # @param web_fetch [WebFetch] specific URL fetch implementation
     # @param code_search [CodeSearch] public source/package search implementation
     # @param web_search_enabled [Boolean, nil] override for web search exposure
     # @param skills [Array<ConfigFiles::Skill>, nil] override discovered skills
     # @param ask_user_question_enabled [Boolean, nil] override question exposure
-    def initialize(workspace: Workspace.new, prompt: nil, web_search: WebSearch.new, web_fetch: WebFetch.new, code_search: CodeSearch.new, web_search_enabled: nil, skills: nil, ask_user_question_enabled: nil, allowed_tool_names: nil, tool_output_compactor: ToolOutputCompactor.new, telemetry_logger: TelemetryLogger.new, context_budget_meter: nil, mcp_clients: nil, tool_approval: nil, approval_for_allowed_tools: false, permission_policy: nil, hook_manager: nil, hook_context: nil, git_committer: nil)
+    def initialize(workspace: Workspace.new, prompt: nil, web_search: WebSearch.new, web_fetch: WebFetch.new, code_search: CodeSearch.new, web_search_enabled: nil, skills: nil, ask_user_question_enabled: nil, allowed_tool_names: nil, editor_prompt_session: nil, tool_output_compactor: ToolOutputCompactor.new, telemetry_logger: TelemetryLogger.new, context_budget_meter: nil, mcp_clients: nil, tool_approval: nil, approval_for_allowed_tools: false, permission_policy: nil, hook_manager: nil, hook_context: nil, git_committer: nil)
       @workspace = workspace
       @prompt = prompt
       @web_search = web_search
@@ -89,6 +92,8 @@ module Kward
       @web_search_enabled = web_search_enabled
       @ask_user_question_enabled = ask_user_question_enabled
       @allowed_tool_names = allowed_tool_names&.map(&:to_s)
+      @editor_prompt_session = editor_prompt_session
+      @shell_prompt_session = nil
       @tool_output_compactor = tool_output_compactor
       @telemetry_logger = telemetry_logger
       @context_budget_meter = context_budget_meter
@@ -109,6 +114,36 @@ module Kward
       @schemas = build_schema_tools.map { |tool| schema_with_metadata(tool) }.freeze
     end
 
+    # Builds a registry scoped to one editor prompt turn.
+    #
+    # Editor prompts may inspect the workspace, but their only write operation
+    # is the in-memory editor buffer. Filesystem and shell mutation tools are
+    # intentionally excluded from this scoped registry.
+    def for_editor_prompt(editor_prompt_session)
+      registry = dup
+      registry.instance_variable_set(:@editor_prompt_session, editor_prompt_session)
+      registry.instance_variable_set(:@shell_prompt_session, nil)
+      registry.instance_variable_set(:@allowed_tool_names, editor_prompt_tool_names)
+      registry.instance_variable_set(:@tools, registry.send(:build_tools).freeze)
+      registry.instance_variable_set(:@schemas, registry.send(:build_schema_tools).map { |tool| registry.send(:schema_with_metadata, tool) }.freeze)
+      registry
+    end
+
+    # Builds a registry scoped to one transient shell-agent turn.
+    #
+    # Shell prompts may inspect the workspace and execute explicitly requested
+    # commands through the active shell, but they cannot write workspace files
+    # through the ordinary file tools or execute against a second shell state.
+    def for_shell_prompt(shell_prompt_session)
+      registry = dup
+      registry.instance_variable_set(:@editor_prompt_session, nil)
+      registry.instance_variable_set(:@shell_prompt_session, shell_prompt_session)
+      registry.instance_variable_set(:@allowed_tool_names, shell_prompt_tool_names)
+      registry.instance_variable_set(:@tools, registry.send(:build_tools).freeze)
+      registry.instance_variable_set(:@schemas, registry.send(:build_schema_tools).map { |tool| registry.send(:schema_with_metadata, tool) }.freeze)
+      registry
+    end
+
     # Executes a model-requested tool call and appends the result to the
     # conversation transcript.
     #
@@ -223,7 +258,7 @@ module Kward
         "web"
       when Tools::ReadSkill
         "skill"
-      when Tools::AskUserQuestion
+      when Tools::AskUserQuestion, Tools::OpenEditor
         "ui"
       else
         "builtin"
@@ -407,11 +442,12 @@ module Kward
     end
 
     def shell_payload(args)
+      shell_cwd = @shell_prompt_session&.shell&.cwd
       {
         tool_name: "run_shell_command",
         command: args[:command] || args["command"],
-        timeout_seconds: args[:timeout_seconds] || args["timeout_seconds"] || Workspace::DEFAULT_COMMAND_TIMEOUT_SECONDS,
-        cwd: @workspace.respond_to?(:root) ? @workspace.root.to_s : nil
+        timeout_seconds: args[:timeout_seconds] || args["timeout_seconds"] || @shell_prompt_session&.timeout_seconds || Workspace::DEFAULT_COMMAND_TIMEOUT_SECONDS,
+        cwd: shell_cwd || (@workspace.respond_to?(:root) ? @workspace.root.to_s : nil)
       }.compact
     end
 
@@ -486,6 +522,9 @@ module Kward
 
     def build_schema_tools
       tools = @tools.values_at(*CORE_TOOL_NAMES)
+      tools << @tools["replace_editor_buffer"] if @tools["replace_editor_buffer"]
+      tools << @tools["open_editor"] if @tools["open_editor"]
+      tools << @tools["prepare_shell_command"] if @tools["prepare_shell_command"]
       tools << @tools["git_commit"] if @tools["git_commit"]
       tools.concat(@tools.values_at("web_search", "fetch_content", "fetch_raw")) if web_search_available?
       tools.concat(@tools.values.select { |tool| tool.is_a?(Tools::MCPTool) })
@@ -507,18 +546,46 @@ module Kward
     end
 
     def core_tools
-      [
+      tools = [
         Tools::ListDirectory.new(workspace: @workspace),
         Tools::ReadFile.new(workspace: @workspace),
         Tools::WriteFile.new(workspace: @workspace),
         Tools::EditFile.new(workspace: @workspace),
-        Tools::RunShellCommand.new(workspace: @workspace),
+        shell_command_tool,
         Tools::CodeSearch.new(code_search: @code_search),
         Tools::SummarizeFileStructure.new(workspace: @workspace),
         Tools::ContextForTask.new(workspace: @workspace),
         Tools::ContextBudgetStats.new(context_budget_meter: @context_budget_meter),
         Tools::RetrieveToolOutput.new
       ]
+      tools << Tools::ReplaceEditorBuffer.new(editor_prompt_session: @editor_prompt_session) if @editor_prompt_session
+      tools << Tools::OpenEditor.new(workspace: @workspace, prompt: @prompt) if editor_available?
+      tools << Tools::PrepareShellCommand.new(shell_prompt_session: @shell_prompt_session) if @shell_prompt_session
+      tools
+    end
+
+    def shell_command_tool
+      if @shell_prompt_session
+        Tools::RunShellCommand.new(shell_prompt_session: @shell_prompt_session)
+      else
+        Tools::RunShellCommand.new(workspace: @workspace)
+      end
+    end
+
+    def editor_available?
+      @prompt&.respond_to?(:edit_file)
+    end
+
+    def editor_prompt_tool_names
+      readonly_tools = CORE_TOOL_NAMES - %w[write_file edit_file run_shell_command]
+      readonly_tools + ["replace_editor_buffer"]
+    end
+
+    def shell_prompt_tool_names
+      readonly_tools = CORE_TOOL_NAMES - %w[write_file edit_file run_shell_command]
+      tools = readonly_tools + %w[run_shell_command prepare_shell_command]
+      tools << "open_editor" if editor_available?
+      tools
     end
 
     def web_search_available?

data/lib/kward/tools/replace_editor_buffer.rb

@@ -0,0 +1,30 @@
+require_relative "base"
+
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  # Model-callable tool wrappers and their argument schemas.
+  module Tools
+    # Replaces the active editor's in-memory draft without saving to disk.
+    class ReplaceEditorBuffer < Base
+      def initialize(editor_prompt_session:)
+        @editor_prompt_session = editor_prompt_session
+        super(
+          "replace_editor_buffer",
+          "Replace the complete contents of the active in-memory editor buffer. This does not save the file.",
+          properties: {
+            content: { type: "string", description: "Complete replacement contents for the editor buffer." }
+          },
+          required: ["content"]
+        )
+      end
+
+      def call(args, _conversation, cancellation: nil)
+        cancellation&.raise_if_cancelled!
+        content = argument(args, :content, "")
+        @editor_prompt_session.replace(content)
+        lines = content.to_s.lines.length
+        "Editor buffer replaced: #{lines} lines, #{content.to_s.bytesize} bytes. The file has not been saved."
+      end
+    end
+  end
+end

data/lib/kward/tools/run_shell_command.rb

@@ -5,17 +5,27 @@ require_relative "../workspace"
 module Kward
   # Model-callable tool wrappers and their argument schemas.
   module Tools
-    # Tool wrapper for bounded shell commands in the workspace.
+    # Tool wrapper for bounded shell commands in the workspace or active shell.
     class RunShellCommand < Base
       # Builds the tool schema and stores the execution dependency.
-      def initialize(workspace:)
+      def initialize(workspace: nil, shell_prompt_session: nil)
+        raise ArgumentError, "RunShellCommand requires a workspace or shell session" unless workspace || shell_prompt_session
+        raise ArgumentError, "RunShellCommand accepts only one execution target" if workspace && shell_prompt_session
+
         @workspace = workspace
+        @shell_prompt_session = shell_prompt_session
+        description = shell_prompt_session ?
+          "Run a bounded noninteractive command in the active embedded shell session." :
+          "Run a shell command from the workspace root."
+        timeout_description = shell_prompt_session ?
+          "Timeout seconds; defaults to the embedded shell setting." :
+          "Timeout seconds; default 30."
         super(
           "run_shell_command",
-          "Run a shell command from the workspace root.",
+          description,
           properties: {
             command: { type: "string", description: "Command to run." },
-            timeout_seconds: { type: "integer", description: "Timeout seconds; default 30." }
+            timeout_seconds: { type: "integer", description: timeout_description }
           },
           required: ["command"]
         )
@@ -24,9 +34,17 @@ module Kward
       # Executes the tool and returns model-facing output text.
       def call(args, _conversation, cancellation: nil)
         command = argument(args, :command, "")
-        timeout_seconds = argument(args, :timeout_seconds, Workspace::DEFAULT_COMMAND_TIMEOUT_SECONDS)
+        timeout_seconds = argument(
+          args,
+          :timeout_seconds,
+          @shell_prompt_session ? @shell_prompt_session.timeout_seconds : Workspace::DEFAULT_COMMAND_TIMEOUT_SECONDS
+        )
 
-        @workspace.run_shell_command(command, timeout_seconds: timeout_seconds, cancellation: cancellation)
+        if @shell_prompt_session
+          @shell_prompt_session.run(command, timeout_seconds: timeout_seconds, cancellation: cancellation)
+        else
+          @workspace.run_shell_command(command, timeout_seconds: timeout_seconds, cancellation: cancellation)
+        end
       end
     end
   end

data/lib/kward/tools/tool_call.rb

@@ -26,7 +26,8 @@ module Kward
       "fetch_raw" => "fetch_raw",
       "git_commit" => "git_commit",
       "read_skill" => "read_skill",
-      "ask_user_question" => "ask_user_question"
+      "ask_user_question" => "ask_user_question",
+      "open_editor" => "open_editor"
     }.freeze
 
     module_function

data/lib/kward/version.rb

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

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

@@ -570,127 +570,6 @@ body.kward-docs #footer {
   color: var(--kward-accent-bright);
 }
 
-/*
-  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.
-*/
-.kward-swosh {
-  box-sizing: content-box;
-  display: inline-block;
-  height: 0.98em;
-  line-height: 0.98;
-  margin: -0.16em -0.08em;
-  overflow: hidden;
-  padding: 0.16em 0.08em;
-  position: relative;
-  vertical-align: top;
-}
-
-.kward-hero h1 .kward-swosh-text {
-  color: var(--kward-ink);
-  display: inline-block;
-  line-height: 0.98;
-  white-space: nowrap;
-  will-change: transform, opacity;
-}
-
-/* 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 18s cubic-bezier(0.22, 0.61, 0.36, 1) infinite;
-}
-
-.kward-swosh-text-b {
-  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%, 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%, 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 left-to-right. All texts keep the accent-bright
-  color of the original "Your agent." span.
-*/
-.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 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%, 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%, 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); }
-}
-
 .kward-lede {
   color: var(--kward-ink);
   font-size: 19px;
@@ -1041,10 +920,6 @@ body.kward-docs .kward-home #footer p {
     font-size: clamp(32px, 10vw, 38px);
   }
 
-  .kward-swosh {
-    max-width: 100%;
-  }
-
   .kward-feature-strip,
   .kward-capabilities ul {
     grid-template-columns: 1fr;

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>Human-in-the-loop permissions</h2><p>Optionally approve edits, commands, web, and MCP calls.</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