makit 0.0.147 → 0.0.153

data/lib/makit/gitlab/pipeline_service_impl.rb

@@ -12,7 +12,7 @@ module Makit
     class PipelineServiceImpl
       # Check if gRPC service is available
       def self.grpc_available?
-        defined?(Gitlab::Pipeline::PipelineService)
+        defined?(Makit::V1::Gitlab::Ci::PipelineService)
       end
       
       # Parse GitLab CI YAML content into Pipeline message
@@ -28,7 +28,7 @@ module Makit
           errors, warnings = validate_pipeline_data(yaml_data)
           
           if grpc_available?
-            Gitlab::Pipeline::ParseYamlResponse.new(
+            Makit::V1::Gitlab::Ci::ParseYamlResponse.new(
               pipeline: pipeline,
               errors: errors,
               warnings: warnings,
@@ -45,8 +45,8 @@ module Makit
           end
         rescue Psych::SyntaxError => e
           if grpc_available?
-            Gitlab::Pipeline::ParseYamlResponse.new(
-              pipeline: Gitlab::Pipeline::Pipeline.new,
+            Makit::V1::Gitlab::Ci::ParseYamlResponse.new(
+              pipeline: Makit::V1::Gitlab::Ci::Pipeline.new,
               errors: ["YAML syntax error: #{e.message}"],
               warnings: [],
               success: false
@@ -61,8 +61,8 @@ module Makit
           end
         rescue StandardError => e
           if grpc_available?
-            Gitlab::Pipeline::ParseYamlResponse.new(
-              pipeline: Gitlab::Pipeline::Pipeline.new,
+            Makit::V1::Gitlab::Ci::ParseYamlResponse.new(
+              pipeline: Makit::V1::Gitlab::Ci::Pipeline.new,
               errors: ["Parse error: #{e.message}"],
               warnings: [],
               success: false
@@ -85,7 +85,7 @@ module Makit
           yaml_content = convert_pipeline_to_yaml(request.pipeline, request.pretty_format, request.indent_size)
           
           if grpc_available?
-            Gitlab::Pipeline::ToYamlResponse.new(
+            Makit::V1::Gitlab::Ci::ToYamlResponse.new(
               yaml_content: yaml_content,
               errors: [],
               success: true
@@ -99,7 +99,7 @@ module Makit
           end
         rescue StandardError => e
           if grpc_available?
-            Gitlab::Pipeline::ToYamlResponse.new(
+            Makit::V1::Gitlab::Ci::ToYamlResponse.new(
               yaml_content: "",
               errors: ["YAML generation error: #{e.message}"],
               success: false
@@ -147,7 +147,7 @@ module Makit
         end
         
         if grpc_available?
-          Gitlab::Pipeline::ValidatePipelineResponse.new(
+          Makit::V1::Gitlab::Ci::ValidatePipelineResponse.new(
             is_valid: errors.empty?,
             errors: errors,
             warnings: warnings,
@@ -214,7 +214,7 @@ module Makit
         end
         
         if grpc_available?
-          Gitlab::Pipeline::MergePipelinesResponse.new(
+          Makit::V1::Gitlab::Ci::MergePipelinesResponse.new(
             merged_pipeline: merged,
             conflicts: conflicts,
             warnings: warnings
@@ -237,7 +237,7 @@ module Makit
         total_variables = pipeline.variables.length + pipeline.jobs.values.sum { |job| job.variables.length }
         
         if grpc_available?
-          Gitlab::Pipeline::GetPipelineStatsResponse.new(
+          Makit::V1::Gitlab::Ci::GetPipelineStatsResponse.new(
             total_jobs: pipeline.jobs.length,
             total_stages: pipeline.stages.length,
             total_artifacts: total_artifacts,
@@ -321,9 +321,9 @@ module Makit
           result.logs.push("Podman version: #{podman_version}")
           
           if grpc_available?
-            Gitlab::Pipeline::ExecutePipelineResponse.new(
+            Makit::V1::Gitlab::Ci::ExecutePipelineResponse.new(
               result: result,
-              success: result.status == Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_SUCCESS,
+              success: result.status == Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_SUCCESS,
               errors: result.errors,
               warnings: result.warnings
             )
@@ -338,13 +338,13 @@ module Makit
           
         rescue StandardError => e
           error_result = create_execution_result(SecureRandom.uuid, Time.now)
-          error_result.status = grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
+          error_result.status = grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
           error_result.errors.push("Pipeline execution failed: #{e.message}")
           error_result.logs.push("Error: #{e.message}")
           error_result.logs.push("Backtrace: #{e.backtrace.join("\n")}")
           
           if grpc_available?
-            Gitlab::Pipeline::ExecutePipelineResponse.new(
+            Makit::V1::Gitlab::Ci::ExecutePipelineResponse.new(
               result: error_result,
               success: false,
               errors: error_result.errors,
@@ -398,7 +398,7 @@ module Makit
         removed_stages = (pipeline1_stages - pipeline2_stages).to_a
         
         if grpc_available?
-          Gitlab::Pipeline::ComparePipelinesResponse.new(
+          Makit::V1::Gitlab::Ci::ComparePipelinesResponse.new(
             are_identical: differences.empty? && added_jobs.empty? && removed_jobs.empty? && added_stages.empty? && removed_stages.empty?,
             differences: differences,
             added_jobs: added_jobs,
@@ -474,9 +474,9 @@ module Makit
       # Create execution result object
       def create_execution_result(execution_id, start_time)
         if grpc_available?
-          Gitlab::Pipeline::PipelineExecutionResult.new(
+          Makit::V1::Gitlab::Ci::PipelineExecutionResult.new(
             execution_id: execution_id,
-            status: Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_RUNNING,
+            status: Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_RUNNING,
             started_at: start_time.iso8601,
             job_results: [],
             logs: [],
@@ -591,12 +591,12 @@ module Makit
       # Create error response
       def create_error_response(message)
         error_result = create_execution_result(SecureRandom.uuid, Time.now)
-        error_result.status = grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
+        error_result.status = grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
         error_result.errors.push(message)
         error_result.logs.push("Error: #{message}")
         
         if grpc_available?
-          Gitlab::Pipeline::ExecutePipelineResponse.new(
+          Makit::V1::Gitlab::Ci::ExecutePipelineResponse.new(
             result: error_result,
             success: false,
             errors: error_result.errors,
@@ -615,9 +615,9 @@ module Makit
       # Execute a single stage
       def execute_stage(stage, pipeline, working_dir, request, execution_id, podman_executable)
         stage_result = if grpc_available?
-          Gitlab::Pipeline::StageExecutionResult.new(
+          Makit::V1::Gitlab::Ci::StageExecutionResult.new(
             stage_name: stage.name,
-            status: Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_RUNNING,
+            status: Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_RUNNING,
             started_at: Time.now.iso8601,
             job_results: []
           )
@@ -692,9 +692,9 @@ module Makit
       # Execute a single job
       def execute_job(job_name, job, pipeline, working_dir, request, execution_id, podman_executable)
         job_result = if grpc_available?
-          Gitlab::Pipeline::JobExecutionResult.new(
+          Makit::V1::Gitlab::Ci::JobExecutionResult.new(
             job_name: job_name,
-            status: Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_RUNNING,
+            status: Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_RUNNING,
             started_at: Time.now.iso8601,
             logs: [],
             errors: []
@@ -798,7 +798,7 @@ module Makit
           if dry_run
             job_result.logs.push("DRY RUN: Would execute job: #{job_name}")
             job_result.logs.push("DRY RUN: Skipping actual execution")
-            job_result.status = grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success
+            job_result.status = grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success
             job_result.exit_code = 0
             job_result.finished_at = Time.now.iso8601
             return job_result
@@ -852,11 +852,11 @@ module Makit
             job_result.finished_at = Time.now.iso8601
             
             if result.success
-              job_result.status = grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success
+              job_result.status = grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success
               job_result.stdout = result.stdout if result.stdout
               job_result.stderr = result.stderr if result.stderr
             else
-              job_result.status = grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
+              job_result.status = grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
               job_result.errors.push("Job failed with exit code #{result.exit_code}")
               job_result.stdout = result.stdout if result.stdout
               job_result.stderr = result.stderr if result.stderr
@@ -867,11 +867,11 @@ module Makit
             job_result.finished_at = Time.now.iso8601
             
             if result[:success]
-              job_result.status = grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success
+              job_result.status = grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success
               job_result.stdout = result[:stdout] if result[:stdout]
               job_result.stderr = result[:stderr] if result[:stderr]
             else
-              job_result.status = grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
+              job_result.status = grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
               job_result.errors.push("Job failed with exit code #{result[:exit_code]}")
               job_result.stdout = result[:stdout] if result[:stdout]
               job_result.stderr = result[:stderr] if result[:stderr]
@@ -879,7 +879,7 @@ module Makit
           end
           
         rescue StandardError => e
-          job_result.status = grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
+          job_result.status = grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
           job_result.errors.push("Job execution error: #{e.message}")
           job_result.logs.push("Error: #{e.message}")
           job_result.finished_at = Time.now.iso8601
@@ -968,45 +968,45 @@ module Makit
 
       # Determine pipeline status from job results
       def determine_pipeline_status(job_results)
-        return grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success if job_results.empty?
+        return grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success if job_results.empty?
         
         failed_jobs = job_results.select do |job|
           if grpc_available?
-            job.status == Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_FAILED
+            job.status == Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_FAILED
           else
             job.status == :failed
           end
         end
         
         if failed_jobs.any?
-          grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
+          grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
         else
-          grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success
+          grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success
         end
       end
 
       # Determine stage status from job results
       def determine_stage_status(job_results)
-        return grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success if job_results.empty?
+        return grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success if job_results.empty?
         
         failed_jobs = job_results.select do |job|
           if grpc_available?
-            job.status == Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_FAILED
+            job.status == Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_FAILED
           else
             job.status == :failed
           end
         end
         
         if failed_jobs.any?
-          grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
+          grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_FAILED : :failed
         else
-          grpc_available? ? Gitlab::Pipeline::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success
+          grpc_available? ? Makit::V1::Gitlab::Ci::PipelineStatus::PIPELINE_STATUS_SUCCESS : :success
         end
       end
 
       def create_empty_pipeline
         if grpc_available?
-          Gitlab::Pipeline::Pipeline.new
+          Makit::V1::Gitlab::Ci::Pipeline.new
         else
           create_empty_pipeline_fallback
         end
@@ -1072,7 +1072,7 @@ module Makit
       end
 
       def convert_yaml_to_pipeline_grpc(yaml_data)
-        pipeline = Gitlab::Pipeline::Pipeline.new
+        pipeline = Makit::V1::Gitlab::Ci::Pipeline.new
         
         pipeline.image = yaml_data["image"] || ""
         pipeline.timeout = yaml_data["timeout"] || 0
@@ -1086,7 +1086,7 @@ module Makit
         
         # Convert cache
         if yaml_data["cache"]
-          cache = Gitlab::Pipeline::Cache.new
+          cache = Makit::V1::Gitlab::Ci::Cache.new
           cache.key = yaml_data["cache"]["key"] || ""
           cache.policy = yaml_data["cache"]["policy"] || ""
           cache.expire_in = yaml_data["cache"]["expire_in"] || 0
@@ -1103,7 +1103,7 @@ module Makit
         # Convert stages
         if yaml_data["stages"]
           yaml_data["stages"].each do |stage_name|
-            stage = Gitlab::Pipeline::Stage.new
+            stage = Makit::V1::Gitlab::Ci::Stage.new
             stage.name = stage_name
             pipeline.stages << stage
           end
@@ -1176,7 +1176,7 @@ module Makit
       end
 
       def convert_yaml_to_job_grpc(yaml_data)
-        job = Gitlab::Pipeline::Job.new
+        job = Makit::V1::Gitlab::Ci::Job.new
         
         job.stage = yaml_data["stage"] || ""
         job.image = yaml_data["image"] || ""

data/lib/makit/io/filesystem_service_impl.rb

@@ -14,7 +14,7 @@ module Makit
 
       # Check if gRPC service is available
       def self.grpc_available?
-        defined?(Makit::Io::FileSystemService)
+        defined?(Makit::V1::Io::FileSystemService)
       end
 
       # Get a single file's content and/or metadata
@@ -48,7 +48,7 @@ module Makit
         end
         
         if self.class.grpc_available?
-          Makit::Io::FileResponse.new(file: Makit::Io::File.new(file_data))
+          Makit::V1::Io::FileResponse.new(file: Makit::V1::Io::File.new(file_data))
         else
           { file: file_data }
         end
@@ -83,7 +83,7 @@ module Makit
         end
         
         if self.class.grpc_available?
-          Makit::Io::FileResponse.new(file: Makit::Io::File.new(file_data))
+          Makit::V1::Io::FileResponse.new(file: Makit::V1::Io::File.new(file_data))
         else
           { file: file_data }
         end
@@ -159,7 +159,7 @@ module Makit
         end
         
         if self.class.grpc_available?
-          Makit::Io::FileList.new(files: files.map { |f| Makit::Io::File.new(f) })
+          Makit::V1::Io::FileList.new(files: files.map { |f| Makit::V1::Io::File.new(f) })
         else
           { files: files }
         end
@@ -231,7 +231,7 @@ module Makit
         result = results.first
         
         if self.class.grpc_available?
-          Makit::Io::FileResponse.new(file: Makit::Io::File.new(result))
+          Makit::V1::Io::FileResponse.new(file: Makit::V1::Io::File.new(result))
         else
           { file: result }
         end
@@ -264,7 +264,7 @@ module Makit
         end
         
         if self.class.grpc_available?
-          chunks.map { |c| Makit::Io::FileChunk.new(c) }
+          chunks.map { |c| Makit::V1::Io::FileChunk.new(c) }
         else
           chunks
         end

data/lib/makit/lint.rb

@@ -0,0 +1,212 @@
+# frozen_string_literal: true
+
+require "json"
+require "yaml"
+
+# This module provides classes for the Makit gem.
+module Makit
+  # Lint utilities for validating JSON and YAML files
+  #
+  # This class provides methods for linting JSON and YAML files,
+  # helping to catch syntax errors and validation issues early.
+  class Lint
+    # Default directories to exclude from linting
+    DEFAULT_EXCLUDE_PATTERNS = [
+      "artifacts/",
+      "bin/",
+      "obj/",
+      ".nuget/",
+      ".git/",
+      ".specify/"
+    ].freeze
+
+    # Lint JSON files based on a glob pattern or filename
+    #
+    # @param pattern [String] Glob pattern (e.g., "**/*.json") or specific filename
+    # @param exclude_patterns [Array<String>] Optional array of path prefixes to exclude
+    # @return [Hash] Hash with :valid (boolean), :errors (array), :file_count (integer)
+    def self.lint_json(pattern, exclude_patterns: DEFAULT_EXCLUDE_PATTERNS)
+      # Determine if pattern is a glob or specific file
+      if File.file?(pattern)
+        json_files = [pattern]
+      else
+        json_files = Dir.glob(pattern)
+          .reject { |f| exclude_patterns.any? { |exclude| f.start_with?(exclude) } }
+          .select { |f| File.file?(f) }
+      end
+
+      if json_files.empty?
+        return {
+          valid: true,
+          errors: [],
+          file_count: 0,
+          message: "No JSON files found to validate"
+        }
+      end
+
+      errors = []
+      json_files.each do |file|
+        begin
+          content = File.read(file)
+          # Remove BOM if present (UTF-8 BOM: EF BB BF)
+          content = content.force_encoding("UTF-8").sub(/\A\xEF\xBB\xBF/, "")
+          JSON.parse(content)
+        rescue JSON::ParserError => e
+          errors << { file: file, error: e.message }
+        end
+      end
+
+      {
+        valid: errors.empty?,
+        errors: errors,
+        file_count: json_files.length
+      }
+    end
+
+    # Lint JSON files and print results
+    #
+    # @param pattern [String] Glob pattern or filename
+    # @param exclude_patterns [Array<String>] Optional array of path prefixes to exclude
+    # @param verbose [Boolean] Whether to print progress dots
+    # @raise [RuntimeError] If validation fails
+    def self.lint_json!(pattern, exclude_patterns: DEFAULT_EXCLUDE_PATTERNS, verbose: true)
+      result = lint_json(pattern, exclude_patterns: exclude_patterns)
+
+      if result[:file_count] == 0
+        puts result[:message] if verbose
+        return result
+      end
+
+      if verbose
+        puts "Validating #{result[:file_count]} JSON file(s)..."
+      end
+
+      # Re-run to show progress dots
+      if verbose && result[:file_count] > 0
+        json_files = File.file?(pattern) ? [pattern] : Dir.glob(pattern)
+          .reject { |f| exclude_patterns.any? { |exclude| f.start_with?(exclude) } }
+          .select { |f| File.file?(f) }
+
+        json_files.each do |file|
+          begin
+            content = File.read(file)
+            content = content.force_encoding("UTF-8").sub(/\A\xEF\xBB\xBF/, "")
+            JSON.parse(content)
+            print "."
+          rescue JSON::ParserError
+            print "F"
+          end
+        end
+        puts "\n"
+      end
+
+      if result[:valid]
+        puts "✓ All JSON files are valid" if verbose
+      else
+        puts "\n✗ Found #{result[:errors].length} invalid JSON file(s):" if verbose
+        result[:errors].each do |err|
+          puts "  - #{err[:file]}: #{err[:error]}" if verbose
+        end
+        raise "JSON validation failed"
+      end
+
+      result
+    end
+
+    # Lint YAML files based on a glob pattern or filename
+    #
+    # @param pattern [String] Glob pattern (e.g., "**/*.yml") or specific filename
+    # @param exclude_patterns [Array<String>] Optional array of path prefixes to exclude
+    # @return [Hash] Hash with :valid (boolean), :errors (array), :file_count (integer)
+    def self.lint_yaml(pattern, exclude_patterns: DEFAULT_EXCLUDE_PATTERNS)
+      # Determine if pattern is a glob or specific file
+      if File.file?(pattern)
+        yaml_files = [pattern]
+      else
+        yaml_files = Dir.glob(pattern)
+          .reject { |f| exclude_patterns.any? { |exclude| f.start_with?(exclude) } }
+          .select { |f| File.file?(f) }
+      end
+
+      if yaml_files.empty?
+        return {
+          valid: true,
+          errors: [],
+          file_count: 0,
+          message: "No YAML files found to validate"
+        }
+      end
+
+      errors = []
+      yaml_files.each do |file|
+        begin
+          content = File.read(file)
+          # Remove BOM if present (UTF-8 BOM: EF BB BF)
+          content = content.force_encoding("UTF-8").sub(/\A\xEF\xBB\xBF/, "")
+          YAML.load(content, permitted_classes: [Symbol, Date, Time], aliases: true)
+        rescue Psych::SyntaxError => e
+          errors << { file: file, error: e.message }
+        rescue => e
+          errors << { file: file, error: e.message }
+        end
+      end
+
+      {
+        valid: errors.empty?,
+        errors: errors,
+        file_count: yaml_files.length
+      }
+    end
+
+    # Lint YAML files and print results
+    #
+    # @param pattern [String] Glob pattern or filename
+    # @param exclude_patterns [Array<String>] Optional array of path prefixes to exclude
+    # @param verbose [Boolean] Whether to print progress dots
+    # @raise [RuntimeError] If validation fails
+    def self.lint_yaml!(pattern, exclude_patterns: DEFAULT_EXCLUDE_PATTERNS, verbose: true)
+      result = lint_yaml(pattern, exclude_patterns: exclude_patterns)
+
+      if result[:file_count] == 0
+        puts result[:message] if verbose
+        return result
+      end
+
+      if verbose
+        puts "Validating #{result[:file_count]} YAML file(s)..."
+      end
+
+      # Re-run to show progress dots
+      if verbose && result[:file_count] > 0
+        yaml_files = File.file?(pattern) ? [pattern] : Dir.glob(pattern)
+          .reject { |f| exclude_patterns.any? { |exclude| f.start_with?(exclude) } }
+          .select { |f| File.file?(f) }
+
+        yaml_files.each do |file|
+          begin
+            content = File.read(file)
+            content = content.force_encoding("UTF-8").sub(/\A\xEF\xBB\xBF/, "")
+            YAML.load(content, permitted_classes: [Symbol, Date, Time], aliases: true)
+            print "."
+          rescue
+            print "F"
+          end
+        end
+        puts "\n"
+      end
+
+      if result[:valid]
+        puts "✓ All YAML files are valid" if verbose
+      else
+        puts "\n✗ Found #{result[:errors].length} invalid YAML file(s):" if verbose
+        result[:errors].each do |err|
+          puts "  - #{err[:file]}: #{err[:error]}" if verbose
+        end
+        raise "YAML validation failed"
+      end
+
+      result
+    end
+  end
+end
+

data/lib/makit/logging/configuration.rb

@@ -88,10 +88,11 @@ module Makit
       #
       # @return [Configuration] default configuration
       def self.default_config
+        require_relative "../logging" unless defined?(Makit::Logging)
         new(
           configurations: [
             { file: $stdout, format: :console },
-            { file: "artifacts/makit.log", format: :json, append: true },
+            { file: Makit::Logging.log_file_path("makit.log"), format: :json, append: true },
           ],
         )
       end

data/lib/makit/logging.rb

@@ -87,6 +87,19 @@ module Makit
       :normal
     end
 
+    # Get the log file path in the user's temp directory
+    # 
+    # For log files that would normally be in the project's artifacts/ directory,
+    # this method returns the path in the user's temp directory (~/.makit/log/)
+    # instead. This prevents log files from cluttering project directories.
+    #
+    # @param filename [String] The log filename (e.g., "makit.log", "debug.log")
+    # @return [String] Full path to the log file in the temp directory
+    def self.log_file_path(filename)
+      require_relative "directories" unless defined?(Makit::Directories)
+      File.join(Makit::Directories::LOG, filename)
+    end
+
     # Get the current verbosity level from the default logger
     #
     # @return [Symbol] current verbosity level (:quiet, :normal, :verbose, :debug)
@@ -415,14 +428,14 @@ module Makit
             },
             # Main log file in JSON format
             {
-              file: "artifacts/makit.log",
+              file: log_file_path("makit.log"),
               format: :json,
               append: true,
               include_metadata: true,
             },
             # Debug log file in text format
             {
-              file: "artifacts/debug.log",
+              file: log_file_path("debug.log"),
               format: :text,
               append: true,
               min_level: :debug,