sight 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24b700f118e81b323388d9dc1413bcb493a8c8625664099fcff2eeb524fbe4e7
-  data.tar.gz: c0b1e78505b39f82909607431c5c7cf27a56545292abb0967887f2a60be04420
+  metadata.gz: 6e488680c7d4ecc42d8cd02b8d2731a315755b35df2a9cf319ed3f0d413e2809
+  data.tar.gz: 375af2bad773014e984f0b89c3333c839dd84bfc8e8cd610357c78bcfd052962
 SHA512:
-  metadata.gz: b3e9f75deef46a4da613023322b833f0bbf86c7f2cc5f3ccde44f30fd7bd0cb1712d4925c5ed18a865e4ff6fe488d787eaba38939c52cea2e0a9d1f62fec4a97
-  data.tar.gz: 6530759983f83fed70bab30adb12fa6bae9990f5554e91170e5547cbeb58514759eb649fe322b1857d895ec0051017ab53ee2b9cbc35bb918b66199c9fbfbf51
+  metadata.gz: 76d83afcd3ac25b084fc22661d9561fd75bd16ef662237b5cf2e1d784225a442ac682740a312a711ae169e16eac1f8d997ff3e68b44fb1222a00a9fd3e077c6a
+  data.tar.gz: 934ab59d60fb58ac4029718705d1551fd6ede47ff0dfcadfefdf45fdd30eddc2060dcc815988060a796cf55cf993e0b9ba82b86426b1bc8043ed974631006099

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.3.0] - 2026-03-04
+
+### Added
+
+- Comment on hunks with `c` — annotations are printed to stdout on quit as markdown
+
+### Changed
+
+- Removed initial-commit diff fallback from `Git.diff`
+
 ## [0.2.0] - 2026-03-04
 
 ### Changed

data/CLAUDE.md

@@ -0,0 +1,29 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+- `bundle exec rake test` — run all tests
+- `ruby -Ilib:test test/test_cli.rb` — run a single test file
+- `ruby -Ilib:test test/test_cli.rb -n test_help_flag` — run a single test method
+- `bundle exec standardrb` — lint
+- `bundle exec standardrb --fix` — lint and auto-fix
+- `bundle exec rake` — run tests + lint (default task)
+
+## Architecture
+
+TUI for closing the loop on AI-generated code changes — browse diffs, jump between hunks, and annotate them. Entry point: `exe/sight` → `CLI.run` → `App.new(files).run`.
+
+**Data flow**: `Git.diff` (raw string) → `DiffParser.parse` (returns `DiffFile[]`) → `App` (curses TUI)
+
+**Key structs** (all in `diff_parser.rb`): `DiffFile(path, hunks)`, `Hunk(context, lines)`, `DiffLine(type, content, lineno, old_lineno)`. `DisplayLine(type, text, lineno)` is the render-side equivalent in `display_line.rb`.
+
+**App** renders per-file views with hunk-based navigation (j/k). Active hunk is highlighted; inactive hunks render in dark gray (color pair 5, color 240).
+
+## Conventions
+
+- Ruby >= 3.2, uses `frozen_string_literal` in all files
+- Linter: StandardRB (ruby_version: 3.4 in `.standard.yml`)
+- Tests: Minitest with stubs/mocks, no test framework beyond minitest
+- Single runtime dependency: `curses ~1.4`

data/README.md

@@ -1,6 +1,6 @@
 # Sight
 
-Terminal UI for browsing git diffs interactively with colors, hunk navigation, and file navigation.
+TUI for closing the loop on AI-generated code changes.
 
 ## Installation
 
@@ -25,6 +25,7 @@ sight
 | `n` | Next file |
 | `p` | Previous file |
 | `?` | Toggle help |
+| `c` | Comment on hunk |
 | `q` / `Esc` | Quit |
 
 ## Development

data/lib/sight/annotation.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Sight
+  Annotation = Struct.new(:file_path, :type, :hunk, :comment, keyword_init: true)
+end

data/lib/sight/annotation_formatter.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Sight
+  module AnnotationFormatter
+    module_function
+
+    def format(annotations)
+      return "" if annotations.empty?
+
+      grouped = annotations.group_by(&:file_path)
+      grouped.map { |path, anns| format_file(path, anns) }.join("\n")
+    end
+
+    def format_file(path, annotations)
+      out = "## File: #{path}\n\n"
+      annotations.each do |ann|
+        context = ann.hunk.context ? " #{ann.hunk.context}" : ""
+        out += "Hunk (@@#{context}):\n"
+        out += "```diff\n"
+        ann.hunk.lines.each do |line|
+          next unless %i[add del].include?(line.type)
+          out += "#{line.content}\n"
+        end
+        out += "```\n"
+        out += "> #{ann.comment}\n\n"
+      end
+      out
+    end
+  end
+end

data/lib/sight/app.rb

@@ -4,7 +4,7 @@ require "curses"
 
 module Sight
   class App
-    attr_reader :files, :file_lines
+    attr_reader :files, :file_lines, :annotations
     attr_accessor :file_idx, :offset, :hunk_idx
 
     def initialize(files)
@@ -14,6 +14,7 @@ module Sight
       @offset = 0
       @hunk_idx = 0
       @hunk_offsets_cache = {}
+      @annotations = []
     end
 
     def run
@@ -146,6 +147,7 @@ module Sight
       when "k" then jump_hunk(-1)
       when "n" then jump_file(1)
       when "p" then jump_file(-1)
+      when "c" then annotate_hunk
       when "?" then show_help
       end
       true
@@ -157,6 +159,7 @@ module Sight
       ["n", "Next file"],
       ["p", "Previous file"],
       ["q / Esc", "Quit"],
+      ["c", "Comment on hunk"],
       ["?", "Toggle this help"]
     ].freeze
 
@@ -196,6 +199,66 @@ module Sight
       end
     end
 
+    def annotate_hunk
+      hunk = files[file_idx].hunks[hunk_idx]
+      return unless hunk
+      comment = prompt_comment("Comment on hunk")
+      return unless comment
+      @annotations << Annotation.new(
+        file_path: files[file_idx].path,
+        type: :hunk,
+        hunk: hunk,
+        comment: comment
+      )
+    end
+
+    def prompt_comment(title)
+      win = Curses.stdscr
+      max_width = 80
+      width = [Curses.cols * 2 / 3, 50].max
+      width = [width, max_width].min
+      height = 5
+      top = (Curses.lines - height) / 2
+      left = (Curses.cols - width) / 2
+
+      draw_box(win, top, left, width, height, title, [""])
+      win.setpos(top + 3, left + 3)
+      win.refresh
+
+      Curses.curs_set(1)
+      text = ""
+      field_width = width - 6
+      redraw_field = -> {
+        win.setpos(top + 3, left + 3)
+        win.addstr(" " * field_width)
+        visible = (text.length > field_width) ? text[-field_width..] : text
+        win.setpos(top + 3, left + 3)
+        win.addstr(visible)
+      }
+      loop do
+        ch = Curses.getch
+        case ch
+        when 10, 13, Curses::KEY_ENTER
+          break
+        when 27
+          text = nil
+          break
+        when Curses::KEY_BACKSPACE, 127, 8
+          unless text.empty?
+            text = text[0..-2]
+            redraw_field.call
+          end
+        else
+          text += ch.chr if ch.is_a?(Integer) && ch >= 32 && ch < 127
+          text += ch if ch.is_a?(String) && ch.length == 1
+          redraw_field.call
+        end
+      end
+      Curses.curs_set(0)
+
+      text&.strip&.empty? ? nil : text&.strip
+    end
+
     def hunk_offsets
       @hunk_offsets_cache[file_idx] ||= begin
         offsets = []

data/lib/sight/cli.rb

@@ -9,7 +9,9 @@ module Sight
         puts "Usage: sight"
         puts "Interactive git diff viewer (staged + unstaged)"
         puts
-        puts "Keys: j/k hunks, n/p files, ? help, q quit"
+        puts "Keys: j/k hunks, n/p files, c comment, ? help, q quit"
+        puts
+        puts "Annotations are printed to stdout on quit."
         return
       end
 
@@ -25,7 +27,12 @@ module Sight
       end
 
       files = DiffParser.parse(raw)
-      App.new(files).run
+      app = App.new(files)
+      app.run
+
+      unless app.annotations.empty?
+        puts AnnotationFormatter.format(app.annotations)
+      end
     end
   end
 end

data/lib/sight/git.rb

@@ -6,10 +6,7 @@ module Sight
 
     def diff
       output, success = run_cmd(["git", "diff", "--no-color", "HEAD"])
-      unless success
-        output, success = run_cmd(["git", "diff", "--no-color", "--cached"], err: [:child, :out])
-        raise Error, "git diff failed: #{output}" unless success
-      end
+      raise Error, "git diff failed" unless success
       output
     end
 

data/lib/sight/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sight
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/sight.rb

@@ -4,6 +4,8 @@ require_relative "sight/version"
 require_relative "sight/display_line"
 require_relative "sight/diff_parser"
 require_relative "sight/git"
+require_relative "sight/annotation"
+require_relative "sight/annotation_formatter"
 require_relative "sight/cli"
 require_relative "sight/app"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sight
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Ariel Rzezak
@@ -23,8 +23,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.4'
-description: A TUI tool to browse git diffs interactively with colors, file navigation,
-  and scrolling.
+description: Browse diffs by hunk, comment on changes, and close the feedback loop
+  with AI agents.
 email:
 - arzezak@gmail.com
 executables:
@@ -33,12 +33,15 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
 - README.md
 - Rakefile
 - exe/sight
 - lib/sight.rb
+- lib/sight/annotation.rb
+- lib/sight/annotation_formatter.rb
 - lib/sight/app.rb
 - lib/sight/cli.rb
 - lib/sight/diff_parser.rb
@@ -70,5 +73,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.7
 specification_version: 4
-summary: Interactive git diff viewer for the terminal
+summary: TUI for closing the loop on AI-generated code changes
 test_files: []