docopslab-dev 0.1.0 → 0.3.0

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: docopslab-dev
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - DocOps Lab
-bindir: exe
+bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
@@ -51,6 +51,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: asciisourcerer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: debride
   requirement: !ruby/object:Gem::Requirement
@@ -197,14 +211,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.2'
 - !ruby/object:Gem::Dependency
   name: inch
   requirement: !ruby/object:Gem::Requirement
@@ -243,94 +257,35 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.adoc
-- assets/config-packs/actionlint/base.yml
-- assets/config-packs/actionlint/project.yml
-- assets/config-packs/htmlproofer/base.yml
-- assets/config-packs/htmlproofer/project.yml
-- assets/config-packs/rubocop/base.yml
-- assets/config-packs/rubocop/project.yml
-- assets/config-packs/shellcheck/base.shellcheckrc
-- assets/config-packs/subtxt/ai-asciidoc-antipatterns.sub.txt
-- assets/config-packs/vale/asciidoc/ExplicitSectionIDs.yml
-- assets/config-packs/vale/asciidoc/ExtraLineBeforeLevel1.yml
-- assets/config-packs/vale/asciidoc/OneSentencePerLine.yml
-- assets/config-packs/vale/asciidoc/PreferSourceBlocks.yml
-- assets/config-packs/vale/asciidoc/ProperAdmonitions.yml
-- assets/config-packs/vale/asciidoc/ProperDLs.yml
-- assets/config-packs/vale/asciidoc/UncleanListStart.yml
-- assets/config-packs/vale/authoring/ButParagraph.yml
-- assets/config-packs/vale/authoring/ExNotEg.yml
-- assets/config-packs/vale/authoring/LiteralTerms.yml
-- assets/config-packs/vale/authoring/Spelling.yml
-- assets/config-packs/vale/base.ini
-- assets/config-packs/vale/config/scripts/ExplicitSectionIDs.tengo
-- assets/config-packs/vale/config/scripts/ExtraLineBeforeLevel1.tengo
-- assets/config-packs/vale/config/scripts/OneSentencePerLine.tengo
-- assets/config-packs/vale/project.ini
-- assets/hooks/pre-commit
-- assets/hooks/pre-push
-- assets/scripts/adoc_section_ids.rb
-- assets/scripts/build-common.sh
-- assets/scripts/build-docker.sh
-- assets/scripts/build.sh
-- assets/scripts/parse_jekyll_asciidoc_logs.rb
-- assets/templates/Gemfile
-- assets/templates/Rakefile
-- assets/templates/gitignore
-- assets/templates/jekyll-asciidoc-fix.prompt.yml
-- assets/templates/spellcheck.prompt.yml
 - docopslab-dev.gemspec
-- docs/agent/AGENTS.md
-- docs/agent/index.md
-- docs/agent/missions/conduct-release.md
-- docs/agent/missions/setup-new-project.md
-- docs/agent/roles/devops-release-engineer.md
-- docs/agent/roles/docops-engineer.md
-- docs/agent/roles/planner-architect.md
-- docs/agent/roles/product-engineer.md
-- docs/agent/roles/product-manager.md
-- docs/agent/roles/project-manager.md
-- docs/agent/roles/qa-testing-engineer.md
-- docs/agent/roles/tech-docs-manager.md
-- docs/agent/roles/tech-writer.md
-- docs/agent/skills/asciidoc.md
-- docs/agent/skills/code-commenting.md
-- docs/agent/skills/fix-broken-links.md
-- docs/agent/skills/fix-jekyll-asciidoc-build-errors.md
-- docs/agent/skills/fix-spelling-issues.md
-- docs/agent/skills/git.md
-- docs/agent/skills/github-issues.md
-- docs/agent/skills/product-release-rollback-and-patching.md
-- docs/agent/skills/rake-cli-dev.md
-- docs/agent/skills/readme-driven-dev.md
-- docs/agent/skills/release-history.md
-- docs/agent/skills/ruby.md
-- docs/agent/skills/schemagraphy-sgyml.md
-- docs/agent/skills/tests-running.md
-- docs/agent/skills/tests-writing.md
-- docs/agent/skills/write-the-docs.md
-- docs/agent/topics/common-project-paths.md
-- docs/agent/topics/dev-tooling-usage.md
-- docs/agent/topics/devops-ci-cd.md
-- docs/agent/topics/product-docs-deployment.md
 - lib/docopslab/dev.rb
 - lib/docopslab/dev/auto_fix_asciidoc.rb
+- lib/docopslab/dev/cast_ops.rb
 - lib/docopslab/dev/checkers.rb
 - lib/docopslab/dev/config_manager.rb
+- lib/docopslab/dev/data_utils.rb
+- lib/docopslab/dev/docker_aware.rb
 - lib/docopslab/dev/file_utils.rb
+- lib/docopslab/dev/git_branch.rb
 - lib/docopslab/dev/git_hooks.rb
 - lib/docopslab/dev/help.rb
 - lib/docopslab/dev/initializer.rb
+- lib/docopslab/dev/library.rb
+- lib/docopslab/dev/library/cache.rb
+- lib/docopslab/dev/library/fetch.rb
 - lib/docopslab/dev/linters.rb
 - lib/docopslab/dev/log_parser.rb
+- lib/docopslab/dev/manifest.rb
 - lib/docopslab/dev/paths.rb
 - lib/docopslab/dev/script_manager.rb
+- lib/docopslab/dev/skim.rb
 - lib/docopslab/dev/spell_check.rb
 - lib/docopslab/dev/sync_ops.rb
 - lib/docopslab/dev/tasks.rb
 - lib/docopslab/dev/tool_execution.rb
 - lib/docopslab/dev/version.rb
 - specs/data/default-manifest.yml
+- specs/data/library-index.yml
 - specs/data/manifest-schema.yaml
 - specs/data/tasks-def.yml
 - specs/data/tools.yml

data/assets/config-packs/actionlint/base.yml

@@ -1,13 +0,0 @@
-# actionlint configuration for DocOps Lab projects
-# This file is synced from docopslab-dev gem
-
-# Disable overly strict rules for common patterns
-ignore:
-  # Allow commonly used but deprecated actions (we'll upgrade gradually)  
-  - 'SC2086:'  # shellcheck rule about double quotes
-  - 'the runner of "ubuntu-latest" is deprecated'
-  
-# Custom shell for shellcheck integration
-shellcheck:
-  enable: true
-  shell-options: "-e SC2086"  # Allow some globbing patterns

data/assets/config-packs/actionlint/project.yml

@@ -1,13 +0,0 @@
-# actionlint configuration for this project
-# References DocOps Lab base configuration
-
-# Project-specific ignores (add as needed):
-ignore:
-  # Example: Ignore specific workflow patterns
-  # - 'workflow "deploy.yml"'
-  # - '"ubuntu-20.04" is deprecated'
-  
-# Project-specific overrides:
-shellcheck:
-  enable: true
-  # shell-options: "-e SC2016"  # Add project-specific ShellCheck exclusions

data/assets/config-packs/htmlproofer/base.yml

@@ -1,27 +0,0 @@
----
-# DocOps Lab HTML-Proofer Base Configuration
-# This provides sensible defaults for DocOps Lab projects
-
-# URL checking options
-check_external_hash: false    # Skip checking external URL fragments (can be slow)
-check_img_http: false         # Allow HTTP images for now
-enforce_https: false          # Don't enforce HTTPS for all links
-
-# URLs to ignore (patterns and strings)
-ignore_urls:
-  - /localhost/               # Skip local development URLs
-  - /127\.0\.0\.1/           # Skip local IPs  
-  - /example\.com/           # Skip example URLs
-  - /foo\.bar/               # Skip placeholder URLs
-  - /fonts.googleapis.com/   # Skip Google Fonts
-  - /fonts.gstatic.com/      # Skip Google Fonts static
-
-# Files to ignore (patterns)
-ignore_files:
-  - slides/                  # Skip slides directories
-
-# Other options
-check_favicon: false         # Don't require favicon
-check_html: true            # Check HTML structure
-check_opengraph: false      # Skip OpenGraph validation
-disable_external: false     # Check external links (can be disabled for speed)

data/assets/config-packs/htmlproofer/project.yml

@@ -1,25 +0,0 @@
-# DocOps Lab HTML-Proofer Configuration
-# Combined base and project configuration for consistent HTML validation
-# URL checking options
-check_external_hash: false    # Skip checking external URL fragments (can be slow)
-check_img_http: false         # Allow HTTP images for now
-enforce_https: false          # Don't enforce HTTPS for all links
-check_favicon: false         # Don't require favicon
-check_html: true            # Check HTML structure
-check_opengraph: false      # Skip OpenGraph validation
-disable_external: false     # Check external links (can be disabled for speed)
-
-# URLs to ignore (patterns and strings)
-ignore_urls:
-  - /localhost/               # Skip local development URLs
-  - /127\.0\.0\.1/           # Skip local IPs  
-  - /example\.com/           # Skip example URLs
-  - /foo\.bar/               # Skip placeholder URLs
-  - /fonts\.googleapis\.com/ # Skip Google Fonts
-  - /fonts\.gstatic\.com/    # Skip Google Fonts static
-  # Add project-specific URL ignores below:
-
-# Files to ignore (patterns)
-ignore_files:
-  - slides/                  # Skip slides directories
-  # Add project-specific file ignores below:

data/assets/config-packs/rubocop/base.yml

@@ -1,130 +0,0 @@
-# RuboCop configuration for DocOps Lab projects
-# This is the baseline configuration distributed via docopslab-dev
-
-plugins:
-  - rubocop-rspec
-
-AllCops:
-  TargetRubyVersion: 3.2
-  NewCops: enable
-  DisplayCopNames: true
-  DisplayStyleGuide: true
-  
-Style/MethodDefParentheses:
-  EnforcedStyle: require_no_parentheses
-
-Style/MethodCallWithArgsParentheses:
-  EnforcedStyle: require_parentheses
-  AllowParenthesesInMultilineCall: true
-  AllowParenthesesInChaining: true
-
-# Allow longer lines for documentation
-Layout/LineLength:
-  Max: 120
-  AllowedPatterns:
-    - '\A\s*#.*\z'   # Comments
-    - '\A\s*\*.*\z'  # Rdoc comments
-
-Metrics/MethodLength:
-  Max: 25
-
-# Allow longer blocks for Rake tasks and RSpec
-Metrics/BlockLength:
-  AllowedMethods:
-    - describe
-    - context
-    - feature
-    - scenario
-    - let
-    - let!
-    - subject
-    - task
-    - namespace
-  Max: 50
-
-# Documentation not required for internal tooling
-Style/Documentation:
-  Enabled: false
-
-# Allow TODO comments
-Style/CommentAnnotation:
-  Keywords:
-    - TODO
-    - FIXME
-    - OPTIMIZE
-    - HACK
-    - REVIEW
-
-Style/CommentedKeyword:
-  Enabled: false
-
-Style/StringLiterals:
-  Enabled: true
-  EnforcedStyle: single_quotes
-
-Style/StringLiteralsInInterpolation:
-  Enabled: true
-  EnforcedStyle: single_quotes
-
-Style/FrozenStringLiteralComment:
-  Enabled: true
-  EnforcedStyle: always
-
-Layout/FirstParameterIndentation:
-  EnforcedStyle: consistent
-
-Layout/ParameterAlignment:
-  EnforcedStyle: with_fixed_indentation
-
-Layout/MultilineMethodCallBraceLayout:
-  EnforcedStyle: same_line
-
-Layout/MultilineMethodCallIndentation:
-  EnforcedStyle: aligned
-
-Layout/FirstMethodArgumentLineBreak:
-  Enabled: true
-
-Layout/TrailingWhitespace:
-  Enabled: true
-
-Layout/EmptyLineAfterGuardClause:
-  Enabled: true
-
-Layout/HashAlignment:
-  Enabled: false
-
-Layout/SpaceAroundOperators:
-  Enabled: false
-
-Layout/SpaceAroundEqualsInParameterDefault:
-  Enabled: false
-  EnforcedStyle: no_space
-
-Metrics/AbcSize:
-  Enabled: false
-
-Metrics/CyclomaticComplexity:
-  Enabled: false
-
-Metrics/PerceivedComplexity:
-  Enabled: false
-
-Lint/UnusedMethodArgument:
-  Enabled: true
-
-Lint/UselessAssignment:
-  Enabled: true
-
-Lint/IneffectiveAccessModifier:
-  Enabled: true
-
-Security/YAMLLoad:
-  Enabled: false # Projects may intentionally use unsafe YAML loading
-
-Security/Eval:
-  Enabled: true # Catch and replace with safer alternatives
-
-# Disable Naming/PredicateMethod - we use generate_, run_, sync_, etc for actions
-Naming/PredicateMethod:
-  Enabled: false

data/assets/config-packs/rubocop/project.yml

@@ -1,8 +0,0 @@
-# DocOps Lab RuboCop Configuration
-
-inherit_from: .vendor/docopslab/rubocop.yml
-
-# Add project-specific overrides below:
-# AllCops:
-#   Exclude:
-#     - scripts/**

data/assets/config-packs/shellcheck/base.shellcheckrc

@@ -1,14 +0,0 @@
-# ShellCheck configuration for DocOps Lab projects
-# This file is synced from docopslab-dev gem
-
-# Disable some overly strict rules for our use cases
-disable=SC2034 # Variable appears unused (common in sourced scripts)
-disable=SC2086 # Double quote to prevent globbing (sometimes we want globbing)
-disable=SC2181 # Check exit code directly with e.g. 'if mycmd;', not indirectly with $?
-
-# Set default shell to bash (most of our scripts are bash)
-shell=bash
-
-# Enable additional optional checks
-enable=quote-safe-variables
-enable=require-variable-braces

data/assets/config-packs/subtxt/ai-asciidoc-antipatterns.sub.txt

@@ -1,11 +0,0 @@
-^\* \*\*(.+)\*\*:\s
-\1::\n
-
-(^=+\s[\W\w].+)\n([\W\w].*)
-\1\n\n\\2
-
-([^\s])\n\n==\s([\w\w])
-\1\n\n\n== \2
-
-^\* (.*) - (.*)
-\1::\n\2\n

data/assets/config-packs/vale/asciidoc/ExplicitSectionIDs.yml

@@ -1,8 +0,0 @@
----
-extends: script
-scope: raw
-level: warning
-message: "Section heading must be preceded by an explicit ID in format [[section-id]] on the line above."
-link: https://docs.asciidoctor.org/asciidoc/latest/sections/custom-ids/
-description: "Ensures all section headings have explicit IDs for better cross-referencing and stable links."
-script: ExplicitSectionIDs.tengo

data/assets/config-packs/vale/asciidoc/ExtraLineBeforeLevel1.yml

@@ -1,7 +0,0 @@
----
-extends: script
-scope: raw
-level: warning
-message: "Level-1 (==) headings must be preceded by two blank lines and an explicit [[section-id]] line."
-description: "Enforces: blank, blank, [[id]], then '== Heading'."
-script: ExtraLineBeforeLevel1.tengo

data/assets/config-packs/vale/asciidoc/OneSentencePerLine.yml

@@ -1,8 +0,0 @@
----
-extends: script
-scope: raw
-level: warning
-message: "Each sentence should be on its own line for better version control diffs and readability."
-link: https://docs.asciidoctor.org/asciidoc/latest/writing/style/#one-sentence-per-line
-description: "Encourages writing one sentence per line to improve readability and version control diffs."
-script: OneSentencePerLine.tengo

data/assets/config-packs/vale/asciidoc/PreferSourceBlocks.yml

@@ -1,8 +0,0 @@
----
-extends: existence
-scope: raw
-level: error
-message: "Use '[source,lang]' with '----' delimiters instead of markdown-style code blocks with '```'."
-link: https://docs.asciidoctor.org/asciidoc/latest/verbatim/source-blocks/
-raw:
-  - '```\w*\n[\s\S]*?\n```'

data/assets/config-packs/vale/asciidoc/ProperAdmonitions.yml

@@ -1,8 +0,0 @@
----
-extends: existence
-scope: raw
-level: error
-message: "Use proper AsciiDoc admonition blocks instead of manual formatting."
-link: https://docs.asciidoctor.org/asciidoc/latest/blocks/admonitions/
-raw:
-  - '^\*\*NOTE:\*\*|^\*\*TIP:\*\*|^\*\*IMPORTANT:\*\*|^\*\*CAUTION:\*\*|^\*\*WARNING:\*\*'

data/assets/config-packs/vale/asciidoc/ProperDLs.yml

@@ -1,7 +0,0 @@
-extends: existence
-message: "Use AsciiDoc definition list syntax (term:: definition) instead of bold/italic text followed by a colon."
-link: https://docs.asciidoctor.org/asciidoc/latest/lists/description/
-level: error
-scope: raw
-raw:
-  - (?m)^(\* )?\*\*?(.+)(:\*\*?|\*\*?:)[\s\n]+(.+)$

data/assets/config-packs/vale/asciidoc/UncleanListStart.yml

@@ -1,8 +0,0 @@
-extends: existence
-message: |
-  Add a blank line before starting a list after a sentence ending in a colon.
-level: warning
-scope: raw
-raw:
-  - '(?m)^.*(?<!:):[ \t]*$(?=\n[\*\.]\s)'
-link: "Tip: run sed -E '/^[^:]+:[^:]*$/ { N; s/:\n([*.])/:\\n\\1/ }' -i yourfile.adoc"

data/assets/config-packs/vale/authoring/ButParagraph.yml

@@ -1,8 +0,0 @@
-extends: existence
-message: "Do not start a paragraph with a 'but'."
-level: error
-scope: paragraph
-action:
-  name: remove
-tokens:
-  - '\n\nBut '

data/assets/config-packs/vale/authoring/ExNotEg.yml

@@ -1,8 +0,0 @@
-# style for replacing /\se\.g\.,?\s/ with `ex: `
-extends: substitution
-scope: text
-level: error
-message: "Use 'ex: ' instead of 'e.g., '."
-link: https://developers.google.com/style/word-list#e.g
-swap:
-  '([Ee])\.g\.,?\s': '\1x: '

data/assets/config-packs/vale/authoring/LiteralTerms.yml

@@ -1,20 +0,0 @@
----
-extends: substitution
-scope: text
-level: suggestion 
-message: "Consider using monospace formatting for '%s'."
-link: https://docs.asciidoctor.org/asciidoc/latest/text/monospace/
-# Technical terms that should typically be in monospace
-swap:
-  '(?i)\bREADME\b': '`README.adoc`'
-  '(?i)\bGemfile\b': '`Gemfile`'
-  '(?i)\bRakefile\b': '`Rakefile`'
-  '(?i)\bDockerfile\b': '`Dockerfile`'
-  '(?i)\b\.env\b': '`.env`'
-  '(?i)\b\.gitignore\b': '`.gitignore`'
-  '(?i)\b\.yml\b': '`.yml`'
-  '(?i)\b\.yaml\b': '`.yaml`'
-  '(?i)\b\.json\b': '`.json`'
-  '(?i)\b\.rb\b': '`.rb`'
-  '(?i)\b\.md\b': '`.md`'
-  '(?i)\b\.adoc\b': '`.adoc`'