tng 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c8aa338f5dbdebc9d44b422799ac8d45863aa4542a37bb1a7e430d3919009a3
-  data.tar.gz: 1dd202876c75519dea0e2bd7726d11de98fd884b7fda1a2a391dab666d9cd5d6
+  metadata.gz: d34efac07c952da91c1d7247d8a3ee215bc9978af6cfcb12ca54d7b4977f599c
+  data.tar.gz: 6818c82d0d8d0694eb3f9d347478514574a34ed2d5b5e2dc2139e8de312d74b3
 SHA512:
-  metadata.gz: 5d703fa9fb959d57ae13401efea2eb445311d81a49c701f5fd10761dc82b9bcb170d84235575712cf32b00f5d836c93572e4e535e78a2be5f71f076877b63d4e
-  data.tar.gz: 311dc4309cf7670e65cb8ba235d6733195f0ea427f32331c91c04f300b3a69c7533e5797f134b64ea78b029bc08beeff804a57dcd16bb03001600f45681e6ceb
+  metadata.gz: 57f305b07faa097c6ff48b96cbca21b2cde388bc372d134d48ac8fbbc03dc808af60fdb1cd03482527812ccf52cf9b6f0ef0ecac00b4f33c3b6c7080ccc69618
+  data.tar.gz: 9529a0f62366e87fd7b6e44c120f53f1019037e9683c3271af184bae8015d4dbae211365b0dcf3b12ed81228840370173118256ffb28f3a8cf2125f8c9d91417

data/README.md

@@ -144,6 +144,25 @@ bundle exec tng -f order.rb -m calculate_total -t
 - Method call chains
 - Mermaid diagram generation
 
+#### Impact Audit
+
+Compare a method against its committed (`HEAD`) version and surface blast radius:
+
+```bash
+# Run impact audit for a method
+bundle exec tng --file app/services/payment_service.rb --method process_payment --impact
+
+# JSON output for automation/CI
+bundle exec tng --file app/services/payment_service.rb --method process_payment --impact --json
+```
+
+**Impact Signals:**
+- Added/removed required parameters
+- Parameter kind/requirement changes
+- Return type changes
+- Variable type drift (inferred)
+- Impacted call sites (files/lines)
+
 #### Clone Detection
 
 Find duplicate code with 3 levels of detection:
@@ -196,6 +215,7 @@ Get machine-readable output for CI/CD integration:
 bundle exec tng --file app/models/user.rb --clones --json
 bundle exec tng --file app/services/payment.rb --deadcode --json
 bundle exec tng --file app/controllers/api_controller.rb --trace --json
+bundle exec tng --file app/services/payment.rb --method process_payment --impact --json
 ```
 
 ## Advanced Features
@@ -298,6 +318,7 @@ Path 3: !discount_code.present? → calculate_tax → total
 | `--method` | `-m` | Method name to analyze |
 | `--audit` | `-a` | Run audit mode |
 | `--trace` | `-t` | Run symbolic trace mode |
+| `--impact` | | Run impact audit mode |
 | `--clones` | `-c` | Run clone detection |
 | `--deadcode` | `-d` | Run dead code detection |
 | `--level` | `-l` | Clone detection level (1, 2, 3, or all) |
@@ -316,6 +337,9 @@ bundle exec tng -f payment_service.rb -m process -a
 # Symbolic trace
 bundle exec tng -f order.rb -m calculate_total -t
 
+# Impact audit
+bundle exec tng -f payment_service.rb -m process --impact
+
 # Clone detection (all levels)
 bundle exec tng -f pricing_service.rb -c
 

data/bin/tng

@@ -56,6 +56,9 @@ class CLI
     example "X-Ray Visualization:", ""
     example "  bundle exec tng app/services/payment_processor.rb process_payment --xray", ""
     example "  bundle exec tng --file=users_controller.rb --method=create --xray --json", ""
+    example ""
+    example "Impact Audit:", ""
+    example "  bundle exec tng --file=app/services/payment_service.rb --method=process --impact", ""
   end
 
   option :file do
@@ -82,6 +85,11 @@ class CLI
     desc "Run in dead code detection mode (unreachable code, unused variables)"
   end
 
+  flag :all do
+    long "--all"
+    desc "Run dead code detection across the entire repo (respects .gitignore)"
+  end
+
   option :level do
     short "-l"
     long "--level=LEVEL"
@@ -99,6 +107,11 @@ class CLI
     desc "Generate and visualize a symbolic trace"
   end
 
+  flag :impact do
+    long "--impact"
+    desc "Run impact audit (compare against Git HEAD)"
+  end
+
   flag :xray do
     long "--xray"
     desc "Generate X-Ray visualization (Mermaid flowchart)"
@@ -157,6 +170,8 @@ class CLI
 
     if params[:fix]
       handle_fix_command
+    elsif params[:impact] && params[:file]
+      run_direct_impact
     elsif params[:trace] && params[:file]
       run_direct_trace
     elsif params[:deadcode] && params[:file]
@@ -201,6 +216,8 @@ class CLI
         normalized << "--audit"
       when /^(?:--)?(trace)$/
         normalized << "--trace"
+      when /^(?:--)?(impact)$/
+        normalized << "--impact"
       when /^(?:--)?(xray)$/
         normalized << "--xray"
       when /^(?:--)?(json|j)$/
@@ -211,6 +228,8 @@ class CLI
         normalized << "--clones"
       when /^(?:--)?(deadcode|d)$/
         normalized << "--deadcode"
+      when /^(?:--)?(all)$/
+        normalized << "--all"
       when /^(?:--)?(level|l)=(.+)$/
         normalized << "--level=#{::Regexp.last_match(2)}"
       when /^(help|h)=(.+)$/
@@ -270,6 +289,8 @@ class CLI
         handle_audit_method
       when "trace"
         handle_trace_method
+      when "impact"
+        handle_impact_method
       when "xray"
         handle_xray_method
       when "clones"
@@ -542,6 +563,11 @@ class CLI
 
   def run_dead_code_detection
     file_path = params[:file]
+    if params[:all] || file_path.nil?
+      run_dead_code_detection_repo
+      return
+    end
+
     unless File.exist?(file_path)
       puts @pastel.red("Error: File '#{file_path}' not found.")
       return
@@ -564,6 +590,114 @@ class CLI
     end
   end
 
+  def run_dead_code_detection_repo
+    project_root = Dir.pwd
+    files = deadcode_repo_files(project_root)
+
+    if files.empty?
+      puts @pastel.yellow("No files found for dead code analysis.")
+      return
+    end
+
+    aggregate = []
+    total = files.length
+    start = Time.now
+
+    def render_deadcode_bar(current, total_count)
+      width = 20
+      ratio = total_count == 0 ? 1.0 : current.to_f / total_count.to_f
+      filled = (ratio * width).round
+      bar = "#" * filled + "-" * (width - filled)
+      percent = (ratio * 100).round
+      "Scanning project... [#{bar}] #{percent}%"
+    end
+
+    if params[:json]
+      # Suppress progress output in JSON mode
+    else
+      print render_deadcode_bar(0, total)
+      $stdout.flush
+    end
+
+    files.each_with_index do |file, idx|
+      rel = file.sub(%r{\A#{Regexp.escape(project_root)}/?}, "")
+      begin
+        result_json = Tng.detect_dead_code(file, true)
+        parsed = JSON.parse(result_json)
+        issues = parsed["dead_code"] || []
+        issues.each do |issue|
+          aggregate << {
+            "type" => issue["type"] || "unknown",
+            "line" => issue["line"] || 0,
+            "message" => issue["message"] || "",
+            "code" => issue["code"] || "",
+            "file" => rel
+          }
+        end
+      rescue => e
+        aggregate << {
+          "type" => "analysis_error",
+          "line" => 0,
+          "message" => "Failed to analyze: #{e.message}",
+          "code" => "",
+          "file" => rel
+        }
+      end
+
+      if !params[:json] && (idx % 10 == 0 || idx == total - 1)
+        print "\r" + render_deadcode_bar(idx + 1, total)
+        $stdout.flush
+      end
+    end
+
+    print "\n" unless params[:json]
+
+    result_payload = {
+      "file" => project_root,
+      "dead_code" => aggregate.map { |i|
+        {
+          "type" => i["type"],
+          "line" => i["line"],
+          "message" => "[#{i["file"]}] #{i["message"]}",
+          "code" => i["code"],
+          "file" => i["file"]
+        }
+      }
+    }
+
+    if params[:json]
+      @go_ui.show_dead_code_results(project_root, result_payload.to_json)
+    else
+      if aggregate.empty?
+        puts "No dead code detected."
+        elapsed = Time.now - start
+        puts format("Summary: Found 0 dead items in %.2fs.", elapsed)
+        return
+      end
+
+      puts "Found dead code:"
+      aggregate.each do |issue|
+        snippet = issue["code"].to_s.strip
+        snippet = snippet.empty? ? "" : " (#{snippet})"
+        puts "- #{issue["file"]}:#{issue["line"]}#{snippet}"
+      end
+      elapsed = Time.now - start
+      puts format("Summary: Found %d dead items in %.2fs.", aggregate.length, elapsed)
+      puts "[Tip] Run 'tng audit' to fix logic bugs in the remaining code."
+    end
+  end
+
+  def deadcode_repo_files(root)
+    begin
+      files_json = Tng.list_deadcode_files(root)
+      files = JSON.parse(files_json)
+      return files.select { |f| File.file?(f) }
+    rescue => e
+      puts @pastel.red("Error listing repo files: #{e.message}")
+      []
+    end
+  end
+
   # Placeholder methods for other component types
   def audit_model_method
     models = nil
@@ -1318,6 +1452,21 @@ class CLI
     end
   end
 
+  def handle_impact_method
+    choice = @go_ui.show_test_type_menu("impact")
+
+    case choice
+    when "controller"
+      impact_controller_method
+    when "model"
+      impact_model_method
+    when "service"
+      impact_service_method
+    when "other"
+      impact_other_method
+    end
+  end
+
   def handle_xray_method
     choice = @go_ui.show_test_type_menu("xray")
 
@@ -1357,6 +1506,30 @@ class CLI
     end
   end
 
+  def impact_controller_method
+    select_controller_and_method("Impact Audit") do |controller, method_info|
+      run_impact_for_method(controller, method_info)
+    end
+  end
+
+  def impact_model_method
+    select_model_and_method("Impact Audit") do |model, method_info|
+      run_impact_for_method(model, method_info)
+    end
+  end
+
+  def impact_service_method
+    select_service_and_method("Impact Audit") do |service, method_info|
+      run_impact_for_method(service, method_info)
+    end
+  end
+
+  def impact_other_method
+    select_other_and_method("Impact Audit") do |file, method_info|
+      run_impact_for_method(file, method_info)
+    end
+  end
+
   def xray_controller_method
     select_controller_and_method("X-Ray") do |controller, method_info|
       run_xray_for_method(controller, method_info)
@@ -1413,6 +1586,39 @@ class CLI
     end
   end
 
+  def run_impact_for_method(file_info, method_info)
+    result_path = nil
+
+    @go_ui.show_spinner("Running impact audit for #{method_info[:name]}...") do
+      begin
+        project_root = Dir.pwd
+        path = File.expand_path(file_info[:path])
+
+        class_name = file_info[:name]
+        impact_json = Tng::Analyzer::Context.analyze_impact(
+          project_root,
+          path,
+          method_info[:name],
+          class_name
+        )
+
+        f = Tempfile.new(['impact', '.json'])
+        f.write(JSON.generate(impact_json))
+        f.close
+        result_path = f.path
+
+        { success: true, message: "Impact audit completed" }
+      rescue => e
+        { success: false, message: e.message }
+      end
+    end
+
+    if result_path
+      @go_ui.show_impact_results(result_path)
+      File.unlink(result_path) if File.exist?(result_path)
+    end
+  end
+
   def run_direct_trace
     file_path = params[:file]
     method_name = params[:method]
@@ -1428,12 +1634,37 @@ class CLI
        return
     end
 
-    file_info = { path: full_path, name: File.basename(full_path) }
+    relative_path = full_path.gsub("#{Dir.pwd}/", "")
+    namespaced_name = relative_path.sub(/\.rb\z/, "").split("/").map(&:camelize).join("::")
+    file_info = { path: full_path, name: namespaced_name }
     method_info = { name: method_name }
 
     run_trace_for_method(file_info, method_info)
   end
 
+  def run_direct_impact
+    file_path = params[:file]
+    method_name = params[:method]
+
+    unless method_name
+      puts @pastel.decorate("Please specify a method name with --method or -m", Tng::UI::Theme.color(:error))
+      return
+    end
+
+    full_path = File.expand_path(file_path)
+    unless File.exist?(full_path)
+      puts @pastel.decorate("File not found: #{full_path}", Tng::UI::Theme.color(:error))
+      return
+    end
+
+    relative_path = full_path.gsub("#{Dir.pwd}/", "")
+    namespaced_name = relative_path.sub(/\.rb\z/, "").split("/").map(&:camelize).join("::")
+    file_info = { path: full_path, name: namespaced_name }
+    method_info = { name: method_name }
+
+    run_impact_for_method(file_info, method_info)
+  end
+
   def run_direct_xray
     return unless check_configuration
 
@@ -1453,7 +1684,9 @@ class CLI
        return
     end
 
-    file_info = { path: full_path, name: File.basename(full_path) }
+    relative_path = full_path.gsub("#{Dir.pwd}/", "")
+    namespaced_name = relative_path.sub(/\.rb\z/, "").split("/").map(&:camelize).join("::")
+    file_info = { path: full_path, name: namespaced_name }
     method_info = { name: method_name }
 
     run_xray_for_method(file_info, method_info)
@@ -1634,15 +1867,20 @@ class CLI
          choice = files.find { |f| f[:name] == selected }
          next unless choice
 
-         # For dead code, we don't need to select a method, just the file.
-         # But this helper yields (file_choice, method_choice).
-         # We might need a simpler selector for dead code if it's file-based only.
-         # Re-using method selector for now if we want per-method, but dead code is usually per-file.
+         methods = extract_other_methods(choice)
+         if methods.empty?
+             @go_ui.show_no_items("methods in #{choice[:name]}")
+             next
+         end
 
-         # Actually, dead code analysis is whole-file.
-         # So we should probably just return the file choice.
+         m_items = methods.map { |m| { name: m[:name], path: choice[:name] } }
+         m_selected = @go_ui.show_list_view("Select Method to #{action_name}", m_items)
+         next if m_selected == "back"
 
-         # Let's implement specific helpers for dead code that just pick files.
+         m_choice = methods.find { |m| m[:name] == m_selected }
+         next unless m_choice
+
+         yield(choice, m_choice)
       end
   end
 

data/lib/tng/ui/go_ui_session.rb

@@ -256,6 +256,14 @@ module Tng
         puts "Trace results error: #{e.message}"
       end
 
+      # Show impact audit results
+      # @param impact_file_path [String] Path to JSON impact file
+      def show_impact_results(impact_file_path)
+        system(@binary_path, "ruby-impact-results", "--file", impact_file_path)
+      rescue StandardError => e
+        puts "Impact results error: #{e.message}"
+      end
+
       # Show X-Ray visualization results
       # @param xray_result [Hash] X-Ray result with mermaid_code
       # @param method_info [Hash] Optional method info for context
@@ -316,7 +324,8 @@ module Tng
               type: issue["type"],
               line: issue["line"],
               message: issue["message"],
-              code: issue["code"]
+              code: issue["code"],
+              file: issue["file"]
             }
           end
         }
@@ -406,6 +415,7 @@ module Tng
             { cmd: "bundle exec tng --file=FILE --method=METHOD", desc: "Direct test generation" },
             { cmd: "bundle exec tng --file=FILE --method=METHOD --audit", desc: "Direct audit mode" },
             { cmd: "bundle exec tng --file=FILE --method=METHOD --trace", desc: "Symbolic trace mode" },
+            { cmd: "bundle exec tng --file=FILE --method=METHOD --impact", desc: "Impact audit mode" },
             { cmd: "bundle exec tng --file=FILE --clones", desc: "Check for code duplicates" },
             { cmd: "bundle exec tng --file=FILE --deadcode", desc: "Run dead code detection" },
             { cmd: "bundle exec tng --file=FILE --method=METHOD --xray", desc: "X-Ray visualization" }
@@ -416,6 +426,7 @@ module Tng
             "Per-method test generation",
             "Code audit for issues & behaviors",
             "Symbolic execution traces",
+            "Impact audit against Git HEAD",
             "Duplicate code detection (Clones)",
             "Dead code detection (Rust-powered)",
             "X-Ray Logic Flow Visualization",
@@ -427,6 +438,7 @@ module Tng
             { flag: "--method=NAME", desc: "Method name to generate test for" },
             { flag: "--audit", desc: "Run audit mode instead of test generation" },
             { flag: "--trace", desc: "Run symbolic trace mode" },
+            { flag: "--impact", desc: "Run impact audit mode" },
             { flag: "--clones", desc: "Run clone detection mode" },
             { flag: "--level=1|2|3|all", desc: "Set clone detection level (default: all)" },
             { flag: "--deadcode", desc: "Run dead code detection" },

data/lib/tng/ui/json_session.rb

@@ -101,6 +101,11 @@ module Tng
         emit_event("result", trace_json)
       end
 
+      def show_impact_results(impact_file_path)
+        impact_json = JSON.parse(File.read(impact_file_path))
+        emit_event("result", impact_json)
+      end
+
       def show_dead_code_results(file_path, results_json)
         parsed = JSON.parse(results_json)
         emit_event("dead_code", parsed)

data/lib/tng/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tng
-  VERSION = "0.5.0"
+  VERSION = "0.5.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tng
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - ralucab
@@ -222,7 +222,7 @@ post_install_message: "┌ TNG ────────────────
   \                                                            │\n│  • bundle exec
   tng --help  - Show help information                 │\n│                                                                    │\n│
   \ \U0001F4A1 Generate tests for individual methods with precision            │\n└────────────────────────────────────────────────────────────
-  v0.5.0 ┘\n"
+  v0.5.1 ┘\n"
 rdoc_options: []
 require_paths:
 - lib