immosquare-cleaner 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7165a24bce4d5074d6c51081764a2689116e996bafa14ed85ddc1fc43ea50e29
-  data.tar.gz: a8b504859e4cfe9f9f1ecf552a058fad07a773b54639630601feee28c5038aeb
+  metadata.gz: 684fefa6f6061c2cfd2a30c10852463e2a8a0605dc8d4078fe9cb8f136bd3f97
+  data.tar.gz: 9437ae1b6de815f2b97d5dd10f61fb3ad412e6989969f73a10b481b9560efd8b
 SHA512:
-  metadata.gz: b6dbd75516dc30b9cecc8c6400597ec6b75c99a70882c9d2bc18523b7dada2d670ecd20287c4de7cdd6e0ad2a2949c64254f6a37b2856ca2cfa434427008809b
-  data.tar.gz: 69c695dc0204e4ef7a7ebfeaec6d1fcad0f5ba8adb8622d33dfc983a31b1453c8c668d149f31dfc344a17083a12c052bffa608c8d4dbd39b3545a6fc3d631f81
+  metadata.gz: d0962e5e3df0bf9493abeed5871e85fa8146787aec41b09ec37a322ccd88fd7d2454d1d08bb97aa03cf153f1e6ff75809b6d7f286fab0bf1f3ad5e4095f15291
+  data.tar.gz: 53315a827d4a2030c1ce6e05bd70c24ded051f9259056fd695261c99e3c3d4e969c89543fb46498e5dfd39ff3a8ec076300352c41860491e020255f8b9edd83f

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 immosquare
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/bin/immosquare-cleaner

@@ -31,16 +31,33 @@ OptionParser.new do |parser|
   parser.on("-p", "--prevent-concurrent-write", "Prevent concurrent write") do
     options[:prevent_concurrent_write] = true
   end
+  parser.on("--hook", "Read the edited file from an AI agent hook payload on stdin") do
+    options[:hook] = true
+  end
   parser.on("-h", "--help", "Prints this help") do
     puts(parser)
     exit
   end
 end.parse!
 
+##============================================================##
+## Hook mode : the edited file comes from the agent's JSON payload.
+## Linters write their reports on stdout, which some agents
+## (Gemini CLI) parse as the hook's JSON answer: everything goes
+## to stderr instead. An unsupported or missing file ends the
+## hook silently with exit 0, so the agent is never blocked.
+##============================================================##
+if options[:hook]
+  file_path = ImmosquareCleaner::Hook.file_path($stdin.read)
+  exit(0) if file_path.nil?
+  $stdout.reopen($stderr)
+else
+  file_path = ARGV[0]
+end
+
 ##============================================================##
 ## Check if the file path is provided
 ##============================================================##
-file_path = ARGV[0]
 if !file_path
   puts("Error: Please provide a file or directory path.")
   exit(1)

data/lib/immosquare-cleaner/directory_cleaner.rb

@@ -37,6 +37,7 @@ module ImmosquareCleaner
       "log",
       "node_modules",
       "target",
+      "testdata",
       "tmp",
       "vendor"
     ].freeze

data/lib/immosquare-cleaner/hook.rb

@@ -0,0 +1,37 @@
+require "json"
+
+module ImmosquareCleaner
+  ##============================================================##
+  ## `immosquare-cleaner --hook` : the file to clean comes from the
+  ## JSON an AI agent pipes on stdin after an edit, not from ARGV.
+  ##
+  ## Each agent nests the edited path differently:
+  ## - Claude Code, Gemini CLI : tool_input.file_path
+  ## - Kimi Code               : tool_input.path
+  ## - Grok                    : toolInput.file_path
+  ## - Cursor (afterFileEdit)  : file_path at the top level
+  ## A relative path is resolved against the payload's `cwd`.
+  ##
+  ## A hook must never block the agent: anything that is not a
+  ## supported file (no path, deleted file, directory, LICENSE,
+  ## .env...) is skipped instead of reported.
+  ##============================================================##
+  module Hook
+    PAYLOAD_KEYS = ["tool_input", "toolInput"].freeze
+    PATH_KEYS    = ["file_path", "path", "target_file"].freeze
+
+    def self.file_path(raw_payload)
+      payload = JSON.parse(raw_payload.to_s)
+      return if !payload.is_a?(Hash)
+
+      sources = PAYLOAD_KEYS.map {|key| payload[key] }.grep(Hash) + [payload]
+      path    = sources.lazy.flat_map {|source| PATH_KEYS.map {|key| source[key] } }.find {|value| value.is_a?(String) && !value.empty? }
+      return if path.nil?
+
+      path = File.expand_path(path, payload["cwd"].is_a?(String) ? payload["cwd"] : Dir.pwd)
+      path if File.file?(path) && ImmosquareCleaner.supported?(path)
+    rescue JSON::ParserError
+      nil
+    end
+  end
+end

data/lib/immosquare-cleaner/processors/go.rb

@@ -0,0 +1,31 @@
+require "shellwords"
+
+module ImmosquareCleaner
+  module Processors
+    class Go < Base
+
+      def self.match?(file_path)
+        file_path.end_with?(".go")
+      end
+
+      def run
+        if !system("which gofmt > /dev/null 2>&1")
+          warn("ERROR: gofmt is not installed. Please install Go with: brew install go")
+          return
+        end
+
+        ##============================================================##
+        ## gofmt flags:
+        ## -s : apply gofmt's simplifications (redundant composite
+        ##      literal types, `s[a:len(s)]` → `s[a:]`...)
+        ## -w : write the result back to the file in place
+        ## Indentation stays in tabs: gofmt has no option for it, and
+        ## converting to spaces would make every Go tool (gopls,
+        ## `gofmt -l` in CI) flag the file as unformatted.
+        ##============================================================##
+        launch_cmds(["gofmt -s -w #{Shellwords.escape(file_path)}"])
+      end
+
+    end
+  end
+end

data/lib/immosquare-cleaner/version.rb

@@ -1,3 +1,3 @@
 module ImmosquareCleaner
-  VERSION = "1.0.2".freeze
+  VERSION = "1.1.0".freeze
 end

data/lib/immosquare-cleaner.rb

@@ -7,6 +7,7 @@ require "fileutils"
 require_relative "immosquare-cleaner/configuration"
 require_relative "immosquare-cleaner/markdown"
 require_relative "immosquare-cleaner/directory_cleaner"
+require_relative "immosquare-cleaner/hook"
 
 ##============================================================##
 ## Processors
@@ -19,6 +20,7 @@ require_relative "immosquare-cleaner/processors/json"
 require_relative "immosquare-cleaner/processors/markdown"
 require_relative "immosquare-cleaner/processors/shell"
 require_relative "immosquare-cleaner/processors/rust"
+require_relative "immosquare-cleaner/processors/go"
 require_relative "immosquare-cleaner/processors/toml"
 require_relative "immosquare-cleaner/processors/yaml"
 require_relative "immosquare-cleaner/processors/prettier"
@@ -123,6 +125,7 @@ module ImmosquareCleaner
       Processors::Markdown,
       Processors::Shell,
       Processors::Rust,
+      Processors::Go,
       Processors::Toml
     ].freeze
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: immosquare-cleaner
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - immosquare
@@ -149,9 +149,11 @@ dependencies:
     - - "<="
       - !ruby/object:Gem::Version
         version: '1000.0'
-description: Immosquare-cleaner streamlines Rails applications by running tools like
-  RuboCop, ERBLint, Stylelint and more. It ensures code quality, readability, and
-  consistency across the application.
+description: immosquare-cleaner formats Ruby, ERB, JS/TS, Rust, Go, TOML, Markdown,
+  Shell, JSON, YAML and CSS files with one consistent house style, delegating each
+  format to the right tool (RuboCop, erb_lint, ESLint, rustfmt, gofmt, taplo, shfmt,
+  Prettier). Run it on a file, a whole repository, on save, or as a Claude Code, Cursor
+  or Gemini CLI hook so every file an AI agent writes comes out formatted.
 email:
 - jules@immosquare.com
 executables:
@@ -160,13 +162,16 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".erb_linters"
+- LICENSE
 - bin/immosquare-cleaner
 - lib/immosquare-cleaner.rb
 - lib/immosquare-cleaner/configuration.rb
 - lib/immosquare-cleaner/directory_cleaner.rb
+- lib/immosquare-cleaner/hook.rb
 - lib/immosquare-cleaner/markdown.rb
 - lib/immosquare-cleaner/processors/base.rb
 - lib/immosquare-cleaner/processors/erb.rb
+- lib/immosquare-cleaner/processors/go.rb
 - lib/immosquare-cleaner/processors/javascript.rb
 - lib/immosquare-cleaner/processors/json.rb
 - lib/immosquare-cleaner/processors/markdown.rb
@@ -201,10 +206,13 @@ files:
 - linters/rubocop/cop/custom_cops/style/kwarg_priority_order.rb
 - linters/rubocop/cop/style/method_call_with_args_parentheses_override.rb
 - package.json
-homepage: https://github.com/immosquare/Immosquare-cleaner
+homepage: https://github.com/immosquare/immosquare-cleaner
 licenses:
 - MIT
-metadata: {}
+metadata:
+  source_code_uri: https://github.com/immosquare/immosquare-cleaner
+  changelog_uri: https://github.com/immosquare/immosquare-cleaner/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/immosquare/immosquare-cleaner/issues
 rdoc_options: []
 require_paths:
 - lib
@@ -222,5 +230,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.22
 specification_version: 4
-summary: A gem to lint and organize files in a Rails application.
+summary: One command to format every file of a repository, built to run as an AI agent
+  hook.
 test_files: []