docopslab-dev 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f556998ac192b16369bebc63f8db4de9f462cbfa58ef418e6b44f9cbf098f941
-  data.tar.gz: 12f94f83dbd59f4edc543f7eadcda1ec81a3a97df6fa0c5ecfc7338cda5bd2c2
+  metadata.gz: 644c00380af7862d5e02eb3c14ec8b1ec824612440cbb292fd9f9cb4f3900a72
+  data.tar.gz: 85187c04d2248a6360a03e82210d5f7c26974f3b15b6a467feef91cd457d1d0d
 SHA512:
-  metadata.gz: 5d5150e8cb8c3dede19e1949dac7b6ee06f72010aecba985c16b4707babf88d0909a4c8962acdcdac27cea8fc71736a1b9f85f7288f55add7d08779e426b1449
-  data.tar.gz: 2f7df7bf2ce6f9f6bc7c6ff9f5a686a4ff4b494a124bfc13114e25eea742de9b9ebc212fa1038b4924408e1134be0314aa0ee713740c349ab3a4f13ef2842679
+  metadata.gz: 80b9f8f128d8d0c27c30a427105fd6f88ed64fc128e2db25ee20ef5ae83df006e80c345984306ab37ea3fc37cccaabea3ff0fae685beb3168df7790824a30362
+  data.tar.gz: 05acd13909ec5358af9f34b20620fc3d9e15d3a0a4b9301df229481aa993f0051ad53288ad5347cbb382d91b44a102d528132699160102f60dd6c4a2c9cf18e6

data/README.adoc

@@ -525,6 +525,34 @@ For full Vale configuration settings ("`keys`") reference, see the link:https://
 
 // end::config-vale[]
 
+[[git-lint]]
+=== git-lint
+
+Git commit message checking for local hooks.
+
+Convention data:: `.config/.vendor/docopslab/commit-conventions.yml`
+Project convention overrides:: `.config/commit-conventions.yml` (inherits via `inherit_from`)
+Base config:: `.config/.vendor/docopslab/git-lint.yml`
+Project config overrides:: `.config/git-lint.local.yml`
+Ephemeral config:: `.config/git-lint.yml`
+Sync command:: `bundle exec rake labdev:sync:configs`
+Branch lint command:: `bundle exec rake labdev:lint:commits`
+Commit-message hook command:: `bundle exec rake labdev:lint:commit[path/to/COMMIT_EDITMSG]`
+
+The generated git-lint config is derived from shared commit convention data so other commit-message linters can reuse the same types, scopes, and prose rules later.
+Commit subjects must follow `<type>[optional scope]: Subject`, use a configured type and scope, start the subject with a capitalized imperative verb, and omit terminal punctuation.
+
+Commit convention overrides are mapping-based.
+Local projects can add or overwrite keys under `rules`, `conventions.types`, and `conventions.scopes`.
+Set a key to `null` in the local file to drop an inherited convention.
+
+Version 6.x of `git-lint` expects an XDG config path named `git-lint/configuration.yml`.
+The `labdev` wrappers bridge `.config/git-lint.yml` into that path at runtime, so use the rake tasks instead of invoking `git-lint` directly.
+
+The distributed `commit-msg` hook runs `labdev:lint:commit` against the unsaved commit message.
+This is a local, commit-time check by design, not a CI gate: fixing a violation caught after a push means rewriting shared history, which the local hook avoids entirely.
+`labdev:lint:commits` remains available for manually linting a branch or arbitrary commit range.
+
 [[htmlproofer]]
 === HTMLProofer
 // tag::config-htmlproofer[]
@@ -938,6 +966,7 @@ The `gh` CLI is preferred and will be used when present.
 
 // end::reference[]
 
+
 // tag::workflow[]
 [[task-reference]]
 == Task Reference
@@ -1024,6 +1053,11 @@ HTMLProofer::
 +
  bundle exec htmlproofer --ignore-urls "/www.github.com/,/foo.com/" ./_site
 
+git-lint::
++
+ bundle exec rake "labdev:lint:commit[.git/COMMIT_EDITMSG]"
+ bundle exec rake labdev:lint:commits
+
 // end::standard-usage[]
 // end::usage[]
 // end::workflow[]
@@ -1181,10 +1215,17 @@ To build the `docopslab/dev` Docker image:
 [.prompt]
  bundle exec rake gemdo:build_docker
 
+[[]]
+
 [[publish-artifacts]]
 === Publish & Deploy Artifacts
 
-For general DocOps Lab release procedures, see link:{xref_docs_release_url}[Release Process (General)].
+Commit changes and push to GitHub before publishing generated artifacts.
+
+[NOTE]
+The `docopslab-dev` gem does not issue official release notices or registrations on GitHub the way other DocOps Lab gems do.
+
+For general DocOps Lab release procedures, see link:https://docopslab.org/docs/release/[Release Process (General)].
 
 The `docopslab-dev` gem and `docopslab/dev` Docker image follow that process with these specific considerations:
 
@@ -1259,4 +1300,4 @@ Documentation released under Creative Commons Attribution 4.0 International (CC
 === Bill of Materials
 
 No externally sourced content or code is contained in this project.
-All third-party dependencies are permissively licensed and are downloaded independently, never provided by DocOps Lab.
+All third-party dependencies are permissively licensed and are downloaded independently, never provided by DocOps Lab.

data/docopslab-dev.gemspec

@@ -32,10 +32,11 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'yaml', '~> 0.2'
 
   # Code quality and linting
-  spec.add_dependency 'asciisourcerer', '~> 0.4'
+  spec.add_dependency 'asciisourcerer', '~> 0.5'
   spec.add_dependency 'debride',        '~> 1.13'
   spec.add_dependency 'fasterer',       '~> 0.11'
   spec.add_dependency 'flog',           '~> 4.8'
+  spec.add_dependency 'git-lint',       '~> 6.2'
   spec.add_dependency 'reek',           '~> 6.5'
   spec.add_dependency 'rubocop',        '~> 1.80'
   spec.add_dependency 'rubocop-rake',   '~> 0.7'

data/lib/docopslab/dev/config_manager.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'fileutils'
+require 'yaml'
+
 module DocOpsLab
   module Dev
     module ConfigManager
@@ -55,6 +58,51 @@ module DocOpsLab
           end
         end
 
+        def generate_git_lint_config _context
+          default_config = load_git_lint_defaults
+          return false unless default_config
+
+          base_config = File.join(Paths.config_vendor_dir, 'git-lint.yml')
+          project_config = '.config/git-lint.local.yml'
+          generated_config = Paths::CONFIG_FILES[:git_lint]
+
+          merged_content = default_config
+          if File.exist?(base_config)
+            merged_content = deep_merge_configs(merged_content, YAML.load_file(base_config) || {})
+          end
+          if File.exist?(project_config)
+            merged_content = deep_merge_configs(merged_content, YAML.load_file(project_config) || {})
+          end
+
+          conventions = load_commit_conventions
+          merged_content = apply_commit_conventions_to_git_lint(merged_content, conventions) if conventions
+
+          rendered = YAML.dump(merged_content)
+          FileUtils.mkdir_p(File.dirname(generated_config))
+
+          if !File.exist?(generated_config) || File.read(generated_config) != rendered
+            File.write(generated_config, rendered)
+            puts "  📝 Generated #{generated_config} from git-lint defaults + DocOps Lab conventions"
+            true
+          else
+            false
+          end
+        end
+
+        def load_commit_conventions
+          base_path = File.join(Paths.config_vendor_dir, 'commit-conventions.yml')
+          local_path = '.config/commit-conventions.yml'
+
+          if File.exist?(local_path)
+            load_inheritable_yaml_config(local_path)
+          elsif File.exist?(base_path)
+            YAML.load_file(base_path) || {}
+          end
+        rescue StandardError => e
+          warn "⚠️  Failed to load commit conventions: #{e.message}"
+          nil
+        end
+
         def load_htmlproofer_config config_path=nil, policy: 'merge'
           config_paths = if config_path && File.exist?(config_path)
                            [config_path]
@@ -99,6 +147,67 @@ module DocOpsLab
           config.transform_keys(&:to_sym)
         end
 
+        def load_git_lint_defaults
+          spec = Gem.loaded_specs['git-lint'] || Gem::Specification.find_all_by_name('git-lint').first
+          unless spec
+            warn "⚠️  git-lint is not installed. Run 'bundle install'."
+            return nil
+          end
+
+          YAML.load_file(File.join(spec.full_gem_path, 'lib/git/lint/configuration/defaults.yml')) || {}
+        rescue StandardError => e
+          warn "⚠️  Failed to load git-lint defaults: #{e.message}"
+          nil
+        end
+
+        def apply_commit_conventions_to_git_lint config, conventions
+          types = convention_slugs(conventions, 'types')
+          scopes = convention_slugs(conventions, 'scopes')
+          separator = conventions.dig('rules', 'subject', 'allowed_scope_separator') || '+'
+          max_length = conventions.dig('rules', 'subject', 'maximum')
+          body_max = conventions.dig('rules', 'body', 'maximum_line_length')
+
+          subject = config.dig('commits', 'subject')
+          if subject && types.any?
+            scope_pattern = git_lint_scope_pattern(scopes, separator)
+            subject['prefix']['includes'] = types.sort.map { |type| "#{Regexp.escape(type)}#{scope_pattern}: " }
+          end
+
+          subject['length']['maximum'] = max_length if subject && max_length
+          body = config.dig('commits', 'body')
+          body['line_length']['maximum'] = body_max if body&.dig('line_length') && body_max
+
+          config
+        end
+
+        def git_lint_scope_pattern scopes, separator
+          return '(?:\\([a-z0-9_-]+\\))?' if scopes.empty?
+
+          escaped_scopes = scopes.sort.map { |scope| Regexp.escape(scope) }
+          escaped_separator = Regexp.escape(separator)
+          "(?:\\((?:#{escaped_scopes.join('|')})(?:#{escaped_separator}(?:#{escaped_scopes.join('|')}))*\\))?"
+        end
+
+        def convention_slugs conventions, key
+          values = conventions.dig('conventions', key)
+          case values
+          when Hash
+            values.keys
+          else
+            Array(values).filter_map { |entry| entry['slug'] if entry.is_a?(Hash) }
+          end
+        end
+
+        def load_inheritable_yaml_config path
+          local = YAML.load_file(path) || {}
+          inherit_from = local.delete('inherit_from')
+          return local unless inherit_from
+
+          base_path = File.expand_path(inherit_from, File.dirname(path))
+          base = File.exist?(base_path) ? YAML.load_file(base_path) || {} : {}
+          deep_merge_configs(base, local)
+        end
+
         def merge_yaml_configs base_path, local_path
           # Implement RuboCop-style inheritance for YAML files
           require 'yaml'

data/lib/docopslab/dev/git_hooks.rb

@@ -119,6 +119,8 @@ module DocOpsLab
             description = case hook_name
                           when 'pre-commit'
                             'Advisory checks & syntax validation (non-blocking)'
+                          when 'commit-msg'
+                            'Commit message style gate (blocking)'
                           when 'pre-push'
                             'Comprehensive linting & quality gate (blocking)'
                           else

data/lib/docopslab/dev/linters.rb

@@ -1,8 +1,10 @@
 # frozen_string_literal: true
 
 require 'open3'
+require 'fileutils'
 require 'pathname'
 require 'sourcerer/util/pathifier'
+require 'tmpdir'
 
 module DocOpsLab
   module Dev
@@ -185,6 +187,174 @@ module DocOpsLab
           success
         end
 
+        def run_git_lint context, target=nil, opts_string=''
+          puts '🧾 Running git-lint...'
+          context.generate_git_lint_config if context.respond_to?(:generate_git_lint_config)
+
+          unless File.exist?(Paths::CONFIG_FILES[:git_lint])
+            puts "❌ No git-lint config found. Run 'labdev:sync:configs' to create one."
+            return false
+          end
+
+          cmd = %w[bundle exec git-lint analyze]
+          if target
+            commits = target.split(',').reject { |sha| merge_commit?(sha) }
+            if commits.empty?
+              puts 'ℹ️  All targeted commits are merge commits (exempt from subject conventions); nothing to check.'
+              return true
+            end
+            cmd += ['--commit', commits.join(',')]
+          else
+            cmd << '--branch'
+          end
+          cmd += opts_string.split unless opts_string.empty?
+
+          success = with_git_lint_config_env do |env|
+            system(env, *cmd)
+          end
+
+          if success
+            puts '✅ git-lint passed'
+          else
+            puts '❌ git-lint found commit message issues'
+          end
+
+          success
+        end
+
+        def merge_commit_message? message_file
+          subject = File.readlines(message_file, chomp: true).find { |line| !line.strip.empty? }
+          return false if subject.nil?
+
+          subject.match?(/\AMerge /)
+        end
+
+        def merge_commit? sha
+          out, status = Open3.capture2('git', 'rev-list', '--no-walk', '--parents', sha)
+          return false unless status.success?
+
+          # First token is the commit itself; anything beyond one remaining token is a second parent.
+          out.strip.split.size > 2
+        end
+
+        def run_git_lint_hook context, message_file
+          puts "🧾 Checking commit message: #{message_file}"
+          context.generate_git_lint_config if context.respond_to?(:generate_git_lint_config)
+
+          unless File.exist?(message_file)
+            puts "❌ Commit message file not found: #{message_file}"
+            return false
+          end
+
+          if merge_commit_message?(message_file)
+            puts 'ℹ️  Merge commit message (exempt from subject conventions); nothing to check.'
+            return true
+          end
+
+          convention_success = validate_commit_message_subject(context, message_file)
+          git_lint_success = with_git_lint_config_env do |env|
+            system(env, 'bundle', 'exec', 'git-lint', '--hook', message_file)
+          end
+
+          if convention_success && git_lint_success
+            puts '✅ Commit message passed'
+            true
+          else
+            puts '❌ Commit message failed'
+            false
+          end
+        end
+
+        def validate_commit_message_subject context, message_file
+          subject = File.readlines(message_file, chomp: true).find { |line| !line.strip.empty? }
+          return true if subject.nil? || subject.match?(/\A(?:fixup|squash|amend)!\s/)
+
+          conventions = context.load_commit_conventions if context.respond_to?(:load_commit_conventions)
+          return true unless conventions
+
+          types = convention_slugs(conventions, 'types').sort
+          scopes = convention_slugs(conventions, 'scopes').sort
+          separator = conventions.dig('rules', 'subject', 'allowed_scope_separator') || '+'
+          reject_punctuation = conventions.dig('rules', 'subject', 'reject_terminal_punctuation')
+          reject_agent_signature = conventions.dig('rules', 'text', 'reject_agent_signature')
+
+          match = subject.match(/\A(?<type>[a-z]+)(?:\((?<scope>[^)]+)\))?: (?<subject>.+)\z/)
+          unless match
+            puts '❌ Commit subject must match `<type>[optional scope]: Subject`.'
+            return false
+          end
+
+          valid = true
+          valid = false unless validate_commit_type(match[:type], types)
+          valid = false unless validate_commit_scopes(match[:scope], scopes, separator)
+          valid = false unless validate_subject_text(match[:subject], reject_punctuation)
+          valid = false if reject_agent_signature && agent_signature?(File.read(message_file))
+          valid
+        end
+
+        def with_git_lint_config_env
+          Dir.mktmpdir('docopslab-dev-git-lint') do |dir|
+            config_dir = File.join(dir, 'git-lint')
+            FileUtils.mkdir_p(config_dir)
+            FileUtils.cp(Paths::CONFIG_FILES[:git_lint], File.join(config_dir, 'configuration.yml'))
+            yield({ 'XDG_CONFIG_HOME' => dir })
+          end
+        end
+
+        def convention_slugs conventions, key
+          values = conventions.dig('conventions', key)
+          case values
+          when Hash
+            values.keys
+          else
+            Array(values).filter_map { |entry| entry['slug'] if entry.is_a?(Hash) }
+          end
+        end
+
+        def validate_commit_type type, types
+          return true if types.include?(type)
+
+          puts "❌ Commit type `#{type}` is not allowed. Use one of: #{types.join(', ')}."
+          false
+        end
+
+        def validate_commit_scopes scope_text, scopes, separator
+          return true if scope_text.nil? || scopes.empty?
+
+          invalid = scope_text.split(separator).reject { |scope| scopes.include?(scope) }
+          return true if invalid.empty?
+
+          puts "❌ Commit scope(s) not allowed: #{invalid.join(', ')}."
+          puts "   Use configured scopes joined with `#{separator}` when multiple scopes are needed."
+          false
+        end
+
+        def validate_subject_text subject_text, reject_punctuation
+          valid = true
+          unless subject_text.match?(/\A[[:upper:]]/)
+            puts '❌ Commit subject must start with a capitalized imperative verb.'
+            valid = false
+          end
+
+          if reject_punctuation && subject_text.match?(/[.?!]\z/)
+            puts '❌ Commit subject must not end with terminal punctuation.'
+            valid = false
+          end
+
+          valid
+        end
+
+        def agent_signature? message
+          patterns = [
+            /Co-authored-by:\s*(?:Codex|Claude|ChatGPT)/i,
+            /Generated with (?:Claude Code|Codex|ChatGPT)/i
+          ]
+          return false unless patterns.any? { |pattern| message.match?(pattern) }
+
+          puts '❌ Commit message must not include agent authorship signatures.'
+          true
+        end
+
         def run_vale context, file_path=nil, opts_string='', output_format: :cli, filter: nil, style_override: nil
           scope = file_path ? :file : :project
           running_on = file_path ? "file: #{file_path}" : scope.to_s

data/lib/docopslab/dev/paths.rb

@@ -18,6 +18,7 @@ module DocOpsLab
       CONFIG_FILES = {
         vale: '.config/vale.ini',
         htmlproofer: '.config/htmlproofer.yml',
+        git_lint: '.config/git-lint.yml',
         rubocop: '.config/rubocop.yml'
       }.freeze
 

data/lib/docopslab/dev/skim.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'json'
+require 'pathname'
 require 'asciisourcerer'
 require 'sourcerer/util/pathifier'
 
@@ -28,17 +29,24 @@ module DocOpsLab
           run_with_format(path, exts: MD_EXTS, form: form, syntax: syntax, overlay: true)
         end
 
+        # Skim a Ruby application for its API surface (Modules, Classes, Methods, etc.). Form and syntax are auto-detected.
+        def run_ruby path, form: nil, syntax: nil
+          # path is path + lib/
+          path = File.join(path, 'lib')
+          run_with_format(path, exts: ['.rb'], form: form, syntax: syntax)
+        end
+
         private
 
-        def run_with_format path, exts:, form: nil, syntax: nil, default_forms: nil, overlay: false
+        def run_with_format path, exts:, form: nil, syntax: nil, **opts
           unless path
             puts '❌ Path is required.'
-            puts 'Usage: bundle exec rake labdev:skim[path,form,syntax]'
+            puts 'Usage: bundle exec rake labdev:skim:<type>[path,form,syntax]'
             return
           end
 
-          forms      = form ? parse_forms(form) : default_forms
-          file_paths = overlay ? resolve_overlay_paths(path, exts) : resolve_paths(path, exts)
+          forms      = form ? parse_forms(form) : opts[:default_forms]
+          file_paths = opts[:overlay] ? resolve_overlay_paths(path, exts) : resolve_paths(path, exts)
 
           if file_paths.empty?
             ext_desc = exts.size == 1 ? exts.first : exts.join(', ')
@@ -51,7 +59,9 @@ module DocOpsLab
           file_paths.each do |fp|
             skim_opts = { categories: cats }
             skim_opts[:forms] = forms if forms
-            results[fp] = Sourcerer::SourceSkim.skim_file(fp, **skim_opts)
+            skim_opts[:descriptions] = true if opts[:descriptions]
+
+            results[relative_path(fp)] = Sourcerer::SourceSkim.skim_file(fp, **skim_opts)
           end
           portable = JSON.parse(JSON.generate(results))
 
@@ -85,6 +95,10 @@ module DocOpsLab
           end
         end
 
+        def relative_path file_path
+          Pathname.new(file_path).relative_path_from(Pathname.pwd).to_s
+        end
+
         def parse_forms form
           form.split(',').map { |f| f.strip.to_sym }
         end
@@ -98,7 +112,7 @@ module DocOpsLab
           return :yaml unless form
 
           syntax = 'yaml' if syntax == 'yml'
-          puts
+
           return syntax.to_sym if syntax
 
           :json

data/lib/docopslab/dev/sync_ops.rb

@@ -257,6 +257,21 @@ module DocOpsLab
           synced_count.positive? || skipped_count.positive?
         end
 
+        def ensure_library_available
+          Library.ensure_available!
+          true
+        rescue StandardError => e
+          puts "❌ #{e.message}"
+          false
+        end
+
+        def load_manifest_or_report_error
+          YAML.load_file(MANIFEST_PATH)
+        rescue StandardError => e
+          puts "❌ Failed to parse #{MANIFEST_PATH}: #{e.message}"
+          nil
+        end
+
         def sync_config_files context, tool_filter: :all, offline: false
           # Validate tool filter parameter
           unless tool_filter == :all || tool_filter.is_a?(String) || tool_filter.is_a?(Symbol)
@@ -273,13 +288,10 @@ module DocOpsLab
             return false
           end
 
-          # Parse manifest
-          begin
-            manifest = YAML.load_file(MANIFEST_PATH)
-          rescue StandardError => e
-            puts "❌ Failed to parse #{MANIFEST_PATH}: #{e.message}"
-            return false
-          end
+          manifest = load_manifest_or_report_error
+          return false unless manifest
+
+          return false unless offline || ensure_library_available
 
           config_packs_root = Library.resolve('config-packs')
           unless config_packs_root && Dir.exist?(config_packs_root)
@@ -383,6 +395,7 @@ module DocOpsLab
           generated_count = 0
           generated_count += 1 if context.generate_vale_config
           generated_count += 1 if context.generate_htmlproofer_config
+          generated_count += 1 if context.generate_git_lint_config
 
           puts '  ✅ All runtime configs up to date' if generated_count.zero?
 

data/lib/docopslab/dev/tasks.rb

@@ -146,6 +146,12 @@ module DocOpsLab
               opts = args[:opts] || ''
               Dev.run_actionlint(opts)
             end
+
+            desc desc_for('run:git_lint')
+            task :git_lint, [:opts] => [] do |_t, args|
+              opts = args[:opts] || ''
+              Dev.run_git_lint(nil, opts)
+            end
           end
 
           # ============================================================
@@ -339,6 +345,29 @@ module DocOpsLab
               end
             end
 
+            desc desc_for('lint:commits')
+            task :commits, %i[target opts] => [] do |_t, args|
+              success = Dev.run_git_lint(args[:target], args[:opts] || '')
+              exit(1) unless success
+            end
+
+            desc desc_for('lint:commit')
+            task :commit, [:path] => [] do |_t, args|
+              unless args[:path]
+                puts 'Usage: bundle exec rake labdev:lint:commit[path/to/COMMIT_EDITMSG]'
+                exit(1)
+              end
+
+              success = Dev.run_git_lint_hook(args[:path])
+              exit(1) unless success
+            end
+
+            desc 'Deprecated alias for labdev:lint:commit'
+            task :commit_msg, [:path] => [] do |_t, args|
+              warn '⚠️  labdev:lint:commit_msg is deprecated; use labdev:lint:commit.'
+              Rake::Task['labdev:lint:commit'].invoke(args[:path])
+            end
+
             desc desc_for('lint:spellcheck')
             task :spellcheck, %i[path opts] => [] do |_t, args|
               path = args[:path]
@@ -390,14 +419,12 @@ module DocOpsLab
             end
 
             desc desc_for('heal:adoc')
-            # Add an optional path argument that defaults to nil
             task :adoc, %i[path] => [] do |_t, args|
               Dev.run_adoc_auto_fix(args[:path])
             end
 
             desc desc_for('heal:all')
             task :all do
-              # if the user passed an argument, we wan to tell them this task does not accept any arguments and we want to peaec out of this operation rather than running it
               if ARGV.any? { |arg| arg.include?('labdev:heal:all') && arg.include?('[') }
                 puts '⚠️  labdev:heal:all does not accept any arguments. Exiting.'
                 puts 'Use labdev:heal:ruby[path] or labdev:heal:adoc[path] to auto-fix specific files.'
@@ -431,6 +458,11 @@ module DocOpsLab
             task :md, %i[path form syntax] => [] do |_t, args|
               Skim.run_md(args[:path], form: args[:form], syntax: args[:syntax])
             end
+
+            desc desc_for('skim:ruby')
+            task :ruby, %i[path form syntax] => [] do |_t, args|
+              Skim.run_ruby(args[:path], form: args[:form], syntax: args[:syntax])
+            end
           end
 
           # ============================================================

data/lib/docopslab/dev/tool_execution.rb

@@ -58,7 +58,7 @@ module DocOpsLab
           # Run command in docopslab/dev container
           # Handle both String and Array command formats
           cmd_str = command.is_a?(Array) ? command.shelljoin : command
-          docker_cmd = "docker run -it --rm -v \"$(pwd):/workspace\" -w /workspace docopslab/dev #{cmd_str}"
+          docker_cmd = "docker run --rm -v \"$(pwd):/workspace\" -w /workspace docopslab/dev #{cmd_str}"
           puts "🐳 Running in Docker: #{cmd_str}"
           system(docker_cmd)
         end

data/lib/docopslab/dev/version.rb

@@ -2,7 +2,7 @@
 
 module DocOpsLab
   module Dev
-    VERSION = '0.3.1'
+    VERSION = '0.4.0'
     RUBY_TARGET = '3.2.7'
   end
 end

data/lib/docopslab/dev.rb

@@ -313,6 +313,14 @@ module DocOpsLab
         ConfigManager.generate_htmlproofer_config(self)
       end
 
+      def generate_git_lint_config
+        ConfigManager.generate_git_lint_config(self)
+      end
+
+      def load_commit_conventions
+        ConfigManager.load_commit_conventions
+      end
+
       def load_htmlproofer_config
         ConfigManager.load_htmlproofer_config
       end
@@ -335,13 +343,21 @@ module DocOpsLab
         Linters.run_actionlint(self, opts_string)
       end
 
+      def run_git_lint target=nil, opts_string=''
+        Linters.run_git_lint(self, target, opts_string)
+      end
+
+      def run_git_lint_hook message_file
+        Linters.run_git_lint_hook(self, message_file)
+      end
+
       def run_all_linters
         Linters.run_all_linters(self)
       end
 
       def run_auto_fix
-        Linters.run_auto_fix
-        AsciiidocAutoFix.fix_asciidoc_files(self)
+        Linters.run_auto_fix(self)
+        AutoFixAsciidoc.fix_asciidoc_files(self)
       end
 
       def run_rubocop_auto_fix path: nil

data/specs/data/default-manifest.yml

@@ -20,6 +20,8 @@ templates:
       target: .gitignore
     - source: templates/README.asciidoc
       target: README.adoc
+    - source: templates/CLAUDE.md
+      target: CLAUDE.md
 
 tools:
   - tool: rubocop
@@ -75,8 +77,23 @@ tools:
         target: .config/actionlint.yml
         synced: false
 
+  - tool: git-lint
+    files:
+      - source: commit-conventions/base.yml
+        target: .config/.vendor/docopslab/commit-conventions.yml
+        synced: true
+      - source: commit-conventions/project.yml
+        target: .config/commit-conventions.yml
+        synced: false
+      - source: git-lint/base.yml
+        target: .config/.vendor/docopslab/git-lint.yml
+        synced: true
+      - source: git-lint/project.yml
+        target: .config/git-lint.local.yml
+        synced: false
+
 library:
   enabled: true
   source:
     repo: DocOps/lab
-    ref: labdev-library
+    ref: labdev-library

data/specs/data/tasks-def.yml

@@ -113,6 +113,14 @@ labdev:
       _test:
         - bundle exec rake 'labdev:run:actionlint'
         - bundle exec rake 'labdev:run:actionlint["-oneline -verbose"]'
+    git_lint:
+      _desc: Run the base git-lint branch analyzer and options.
+      _args:
+        opts:
+          summ: Additional arguments to pass to the git-lint command.
+          required: false
+      _test:
+        - bundle exec rake 'labdev:run:git_lint'
   sync:
     _desc: Sync all managed files (configs, scripts, docs, styles, etc)
     all:
@@ -270,6 +278,23 @@ labdev:
         opts:
           summ: Additional options to pass to actionlint
           required: false
+    commits:
+      _desc: Run git-lint on current branch commits or specific commit SHAs
+      _args:
+        target:
+          summ: Optional commit SHA or comma-separated commit SHAs to lint
+          required: false
+        opts:
+          summ: Additional options to pass to git-lint
+          required: false
+    commit:
+      _desc: Run git-lint on an unsaved commit message file
+      _args:
+        path:
+          summ: Path to the commit message file passed by the commit-msg hook
+          required: true
+    commit_msg:
+      _alias: "labdev:lint:commit"
     spellcheck:
       _desc: Generate spellcheck report on content files
       _args:
@@ -337,7 +362,7 @@ labdev:
         - bundle exec rake 'labdev:show:rule[rubocop,Layout/LineLength]'
         - bundle exec rake 'labdev:show:rule[vale,DocOpsLab-Authoring.ExNotEg]'
   skim:
-    _desc: Skim source files for machine-oriented structured outlines (AsciiDoc + Markdown autodetect)
+    _desc: Skim source files for machine-oriented structured outlines (AsciiDoc, Markdown, Ruby)
     _args:
       path:
         summ: |
@@ -402,7 +427,8 @@ labdev:
         form:
           summ: |
             Output shape: tree, flat, or tree,flat (comma-separated).
-            Defaults to flat for Markdown. When form is explicitly passed, output defaults to JSON.
+            Defaults to flat for Markdown.
+            When form is explicitly passed, output defaults to JSON.
           required: false
         syntax:
           summ: |
@@ -413,6 +439,23 @@ labdev:
         - bundle exec rake 'labdev:skim:md[.agent/docs/]'
         - bundle exec rake 'labdev:skim:md[.agent/docs/,flat,json]'
         - bundle exec rake 'labdev:skim:md[.agent/docs/:_docs/agent/,flat,json]'
+    ruby:
+      _desc: Use ri to detect API surface (Modules, Classes, Methods, etc.).
+      _args:
+        path:
+          summ: |
+            Optional path to Ruby gem directory to skim. (Default: '.')
+          required: false
+        form:
+          summ: |
+            Output shape: tree, flat, or tree,flat (comma-separated).
+            Defaults to tree. When form is explicitly passed, output defaults to JSON.
+          required: false
+        syntax:
+          summ: |
+            Override output format: json or yaml.
+            Default: yaml when form is omitted; json when form is explicitly passed.
+          required: false
   # ADDING:
   help:
     _desc: Show help information about labdev tasks
@@ -430,4 +473,3 @@ labdev:
           When a task_string is passed, shows all docstrings from this file for that task.
         required: false
     _test: []
-

data/specs/data/tools.yml

@@ -57,4 +57,11 @@
   config:
     inheritance: native         # Supports standard YAML patterns
     uses_vendor_base: true      # Syncs base config to .vendor/
-    format: YAML
+    format: YAML
+
+- slug: git-lint
+  name: git-lint
+  config:
+    inheritance: generated_yaml  # Builds .config/git-lint.yml from shared conventions
+    uses_vendor_base: true
+    format: YAML

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docopslab-dev
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - DocOps Lab
@@ -57,14 +57,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: debride
   requirement: !ruby/object:Gem::Requirement
@@ -107,6 +107,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.8'
+- !ruby/object:Gem::Dependency
+  name: git-lint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.2'
 - !ruby/object:Gem::Dependency
   name: reek
   requirement: !ruby/object:Gem::Requirement