ace-lint 0.25.0

data/lib/ace/lint.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+require_relative "lint/version"
+
+# Load ace-config for configuration cascade management
+require "ace/support/config"
+
+# Load ace-b36ts for compact ID generation
+require "ace/b36ts"
+
+# Models
+require_relative "lint/models/validation_error"
+require_relative "lint/models/lint_result"
+
+# Atoms
+require_relative "lint/atoms/type_detector"
+require_relative "lint/atoms/kramdown_parser"
+require_relative "lint/atoms/yaml_validator"
+require_relative "lint/atoms/frontmatter_extractor"
+require_relative "lint/atoms/pattern_matcher"
+require_relative "lint/atoms/validator_registry"
+require_relative "lint/atoms/config_locator"
+require_relative "lint/atoms/skill_schema_loader"
+require_relative "lint/atoms/allowed_tools_validator"
+require_relative "lint/atoms/comment_validator"
+
+# Molecules
+require_relative "lint/molecules/markdown_linter"
+require_relative "lint/molecules/yaml_linter"
+require_relative "lint/molecules/frontmatter_validator"
+require_relative "lint/molecules/kramdown_formatter"
+require_relative "lint/molecules/group_resolver"
+require_relative "lint/molecules/validator_chain"
+require_relative "lint/molecules/skill_validator"
+
+# Organisms
+require_relative "lint/organisms/lint_orchestrator"
+require_relative "lint/organisms/result_reporter"
+require_relative "lint/organisms/report_generator"
+require_relative "lint/organisms/lint_doctor"
+
+# Commands
+require_relative "lint/cli/commands/lint"
+
+# CLI
+require_relative "lint/cli"
+
+module Ace
+  module Lint
+    class Error < StandardError; end
+
+    # Check if debug mode is enabled
+    # @return [Boolean] True if debug mode is enabled
+    def self.debug?
+      ENV["ACE_DEBUG"] == "1" || ENV["DEBUG"] == "1"
+    end
+
+    # Load general ace-lint configuration using ace-config cascade
+    # Follows ADR-022: Configuration Default and Override Pattern
+    # @return [Hash] Configuration hash with defaults merged
+    def self.config
+      @config ||= resolve_lint_config(nil, "config.yml")
+    end
+
+    # Load kramdown-specific configuration using ace-config cascade
+    # Config location: .ace/lint/kramdown.yml
+    # @return [Hash] Kramdown configuration hash with defaults merged
+    def self.kramdown_config
+      @kramdown_config ||= resolve_lint_config("kramdown", "kramdown.yml")
+    end
+
+    # Load Ruby-specific configuration using ace-config cascade
+    # Config location: .ace/lint/ruby.yml
+    # @return [Hash] Ruby configuration hash with defaults merged
+    def self.ruby_config
+      @ruby_config ||= resolve_lint_config("ruby", "ruby.yml")
+    end
+
+    # Load Markdown-specific configuration using ace-config cascade
+    # Config location: .ace/lint/markdown.yml
+    # @return [Hash] Markdown configuration hash with defaults merged
+    def self.markdown_config
+      @markdown_config ||= resolve_lint_config("markdown", "markdown.yml")
+    end
+
+    # Reset config cache (useful for testing)
+    def self.reset_config!
+      @config = nil
+      @kramdown_config = nil
+      @ruby_config = nil
+      @markdown_config = nil
+      Atoms::SkillSchemaLoader.reset_cache!
+    end
+
+    # Resolve lint configuration using ace-config cascade
+    # Follows ADR-022: Configuration Default and Override Pattern
+    # @param filename_base [String, nil] Config filename without extension (nil for default config)
+    # @param fallback_filename [String] Fallback filename for gem defaults
+    # @return [Hash] Configuration hash with defaults merged
+    def self.resolve_lint_config(filename_base, fallback_filename)
+      gem_root = Gem.loaded_specs["ace-lint"]&.gem_dir ||
+        File.expand_path("../..", __dir__)
+
+      resolver = Ace::Support::Config.create(
+        config_dir: ".ace",
+        defaults_dir: ".ace-defaults",
+        gem_path: gem_root
+      )
+
+      config = if filename_base
+        resolver.resolve_namespace("lint", filename: filename_base)
+      else
+        resolver.resolve_namespace("lint")
+      end
+      config.data
+    rescue => e
+      warn "Warning: Could not load #{fallback_filename} config: #{e.message}" if debug?
+      load_gem_defaults_fallback("lint", fallback_filename)
+    end
+    private_class_method :resolve_lint_config
+
+    # Load gem defaults directly as fallback when cascade resolution fails
+    # This ensures configuration is never silently erased due to YAML errors
+    # or user config issues
+    # @param namespace [String] Config namespace (e.g., "lint")
+    # @param filename [String] Config filename (e.g., "config.yml", "kramdown.yml")
+    # @return [Hash] Defaults hash or empty hash if defaults also fail
+    def self.load_gem_defaults_fallback(namespace, filename)
+      gem_root = Gem.loaded_specs["ace-lint"]&.gem_dir ||
+        File.expand_path("../..", __dir__)
+      defaults_path = File.join(gem_root, ".ace-defaults", namespace, filename)
+
+      return {} unless File.exist?(defaults_path)
+
+      YAML.safe_load_file(defaults_path, permitted_classes: [Date], aliases: true) || {}
+    rescue
+      {} # Only return empty hash if even defaults fail to load
+    end
+    private_class_method :load_gem_defaults_fallback
+  end
+end

metadata

@@ -0,0 +1,248 @@
+--- !ruby/object:Gem::Specification
+name: ace-lint
+version: !ruby/object:Gem::Version
+  version: 0.25.0
+platform: ruby
+authors:
+- Michal Czyz
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ace-support-config
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: ace-support-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+- !ruby/object:Gem::Dependency
+  name: ace-b36ts
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: ace-support-cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: kramdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: kramdown-parser-gfm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.19'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.57'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.57'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+description: ace-lint provides Ruby-native linting for markdown (kramdown), YAML (Psych),
+  Ruby files (StandardRB/RuboCop), and frontmatter without Node.js or Python dependencies.
+email:
+- mc@cs3b.com
+executables:
+- ace-lint
+extensions: []
+extra_rdoc_files: []
+files:
+- ".ace-defaults/lint/config.yml"
+- ".ace-defaults/lint/kramdown.yml"
+- ".ace-defaults/lint/markdown.yml"
+- ".ace-defaults/lint/ruby.yml"
+- ".ace-defaults/lint/skills.yml"
+- ".ace-defaults/nav/protocols/wfi-sources/ace-lint.yml"
+- CHANGELOG.md
+- LICENSE
+- README.md
+- Rakefile
+- exe/ace-lint
+- handbook/skills/as-lint-fix-issue-from/SKILL.md
+- handbook/skills/as-lint-process-report/SKILL.md
+- handbook/skills/as-lint-run/SKILL.md
+- handbook/workflow-instructions/lint/process-report.wf.md
+- handbook/workflow-instructions/lint/run.wf.md
+- lib/ace/lint.rb
+- lib/ace/lint/atoms/allowed_tools_validator.rb
+- lib/ace/lint/atoms/base_runner.rb
+- lib/ace/lint/atoms/comment_validator.rb
+- lib/ace/lint/atoms/config_locator.rb
+- lib/ace/lint/atoms/frontmatter_extractor.rb
+- lib/ace/lint/atoms/kramdown_parser.rb
+- lib/ace/lint/atoms/pattern_matcher.rb
+- lib/ace/lint/atoms/rubocop_runner.rb
+- lib/ace/lint/atoms/skill_schema_loader.rb
+- lib/ace/lint/atoms/standardrb_runner.rb
+- lib/ace/lint/atoms/type_detector.rb
+- lib/ace/lint/atoms/validator_registry.rb
+- lib/ace/lint/atoms/yaml_parser.rb
+- lib/ace/lint/atoms/yaml_validator.rb
+- lib/ace/lint/cli.rb
+- lib/ace/lint/cli/commands/lint.rb
+- lib/ace/lint/models/lint_result.rb
+- lib/ace/lint/models/validation_error.rb
+- lib/ace/lint/molecules/frontmatter_validator.rb
+- lib/ace/lint/molecules/group_resolver.rb
+- lib/ace/lint/molecules/kramdown_formatter.rb
+- lib/ace/lint/molecules/markdown_linter.rb
+- lib/ace/lint/molecules/offense_deduplicator.rb
+- lib/ace/lint/molecules/ruby_linter.rb
+- lib/ace/lint/molecules/skill_validator.rb
+- lib/ace/lint/molecules/validator_chain.rb
+- lib/ace/lint/molecules/yaml_linter.rb
+- lib/ace/lint/organisms/lint_doctor.rb
+- lib/ace/lint/organisms/lint_orchestrator.rb
+- lib/ace/lint/organisms/report_generator.rb
+- lib/ace/lint/organisms/result_reporter.rb
+- lib/ace/lint/version.rb
+homepage: https://github.com/cs3b/ace
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/cs3b/ace
+  source_code_uri: https://github.com/cs3b/ace/tree/main/ace-lint/
+  changelog_uri: https://github.com/cs3b/ace/blob/main/ace-lint/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Ruby-native linting for markdown, YAML, and Ruby with no Node.js or Python
+test_files: []