docopslab-dev 0.1.0 → 0.2.0

data/specs/data/tasks-def.yml

@@ -18,15 +18,16 @@ labdev:
     _desc: Run assessments on the project environment and managed assets
     env:
       _desc: Assess the local environment and configuration
-    updates:
-      _desc: Check for updates to managed assets from upstream
     all:
       _alias: "labdev:check"
   init:
+    _desc: Initialize development environment assets for this project
     all:
       _desc: Bootstrap the development environment for this project
     docs:
       _desc: Sync agent documentation files to project
+    templates:
+      _desc: Bootstrap cast targets from prime templates (init-only; skips existing files)
   run: 
     # there is no labdev:run:all
     script:
@@ -87,15 +88,19 @@ labdev:
     shellcheck:
       _desc: Run the base shellcheck command and options.
       _args:
+        path:
+          summ: Optional path to a specific file, directory, or glob to check.
+          required: false
         opts:
           summ: Additional arguments to pass to the shellcheck command.
           docs: |
             Use like:
-             bundle exec rake 'labdev:run:shellcheck["--enable=all --format=gcc"]'
+             bundle exec rake 'labdev:run:shellcheck[scripts/build.sh,"--enable=all --format=gcc"]'
           required: false
       _test:
         - bundle exec rake 'labdev:run:shellcheck'
-        - bundle exec rake 'labdev:run:shellcheck["--enable=all --format=gcc"]'
+        - bundle exec rake 'labdev:run:shellcheck[scripts/build.sh]'
+        - bundle exec rake 'labdev:run:shellcheck[scripts/,"--enable=all --format=gcc"]'
     actionlint:
       _desc: Run the base actionlint command and options.
       _args:
@@ -111,16 +116,26 @@ labdev:
   sync:
     _desc: Sync all managed files (configs, scripts, docs, styles, etc)
     all:
-      _alias: "labdev:sync"
+      _desc: Check library freshness then sync all managed assets (configs, scripts, docs, templates, hooks, styles)
     configs:
       _desc: Sync configuration files from config pack
     scripts:
       _desc: Update non-local (`.vendor/`) scripts from upstream
     docs:
       _desc: Sync files to untracked local paths
-      # _args:
-      #   force:
-      # GET RID OF docs[force], this makes no sense, we always overwrite
+    templates:
+      _desc: Sync canonical blocks from prime templates into manifest cast targets
+      _args:
+        path:
+          summ: Optional target file path to restrict the sync to a single entry.
+          required: false
+        dry:
+          summ: Pass 'dry' to preview changes without writing files.
+          required: false
+      _test:
+        - bundle exec rake labdev:sync:templates
+        - bundle exec rake 'labdev:sync:templates[AGENTS.md]'
+        - bundle exec rake 'labdev:sync:templates[AGENTS.md,dry]'
     styles:
       _desc: Sync Vale styles from gem source to project
       local:
@@ -129,6 +144,22 @@ labdev:
         _desc: Sync custom styles from gem and download remote packages
     hooks:
       _desc: Update git hooks from templates (interactive)
+    library:
+      _desc: Fetch the remote library (if stale) and sync content to manifest-configured paths
+      _test:
+        - bundle exec rake labdev:sync:library
+      stage:
+        _desc: Stage a local library directory into the cache and sync to project paths (bypasses remote fetch)
+        _args:
+          path:
+            summ: |
+              Optional path to the local library directory to stage.
+              Defaults to manifest library.local_path, then .library/ in the
+              current directory, then ../lab/.library/ for downstream projects.
+            required: false
+        _test:
+          - bundle exec rake labdev:sync:library:stage
+          - bundle exec rake 'labdev:sync:library:stage[../lab/.library]'
     vale:
       _desc: Sync Vale config and all styles (custom + remote packages)
       local:
@@ -286,9 +317,13 @@ labdev:
           required: false
   show:
     scripts:
-      _desc: List available script templatest
+      _desc: List available script templates
     hooks:
       _desc: List available hook templates
+    library:
+      _desc: Show the current library cache status and version
+      _test:
+        - bundle exec rake labdev:show:library
     rule:
       _desc: Show details about a specific linting rule
       _args:
@@ -301,13 +336,90 @@ labdev:
       _test:
         - 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)
+    _args:
+      path:
+        summ: |
+          File path, directory, or glob of source files.
+          Format auto-detected from extension.
+        required: true
+      form:
+        summ: |
+          Output shape: tree, flat, or tree,flat (comma-separated).
+          Defaults to tree for AsciiDoc, flat for Markdown.
+          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
+    _test:
+      - bundle exec rake 'labdev:skim[README.adoc]'
+      - bundle exec rake 'labdev:skim[.,flat]'
+      - bundle exec rake 'labdev:skim[.,tree]'
+      - bundle exec rake 'labdev:skim[*.adoc,,json]'
+      - bundle exec rake 'labdev:skim[.,both]'
+    adoc:
+      _desc: Skim AsciiDoc source files using Sourcerer::SourceSkim
+      _args:
+        path:
+          summ: File path, directory, or glob of AsciiDoc source files.
+          required: true
+        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
+      _test:
+        - bundle exec rake 'labdev:skim:adoc[README.adoc]'
+        - bundle exec rake 'labdev:skim:adoc[.,flat]'
+        - bundle exec rake 'labdev:skim:adoc[*.adoc,,yaml]'
+    md:
+      _desc: Skim Markdown source files using Sourcerer::SourceSkim. Supports upstream:local overlay path syntax.
+      _docs: |
+        Accepts a single path or an upstream:local overlay pair (colon-separated).
+
+        With two paths, local files shadow upstream files sharing the same relative path,
+        and local-only files are appended. This is useful when a project maintains local
+        additions or overrides alongside a synced upstream docs library.
+
+        Examples:
+          Single path:   .agent/docs/
+          Overlay pair:  .agent/docs/:_docs/agent/
+      _args:
+        path:
+          summ: |
+            File path, directory, or glob of Markdown source files.
+            Optionally provide two directories as upstream:local to merge with local overrides taking precedence.
+          required: true
+        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.
+          required: false
+        syntax:
+          summ: |
+            Override output format: json or yaml.
+            Default: yaml when form is omitted; json when form is explicitly passed.
+          required: false
+      _test:
+        - 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]'
   # ADDING:
   help:
     _desc: Show help information about labdev tasks
     _docs: |
       Default behavior is to show general help information.
 
-      Use like:
+      Use like: 
        bundle exec rake 'labdev:help[lint:ruby]'
     _args:
       task_string:

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: docopslab-dev
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.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
@@ -243,45 +257,9 @@ 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/misc/bash-styles.md
 - docs/agent/missions/conduct-release.md
 - docs/agent/missions/setup-new-project.md
 - docs/agent/roles/devops-release-engineer.md
@@ -294,6 +272,7 @@ files:
 - docs/agent/roles/tech-docs-manager.md
 - docs/agent/roles/tech-writer.md
 - docs/agent/skills/asciidoc.md
+- docs/agent/skills/bash-cli-dev.md
 - docs/agent/skills/code-commenting.md
 - docs/agent/skills/fix-broken-links.md
 - docs/agent/skills/fix-jekyll-asciidoc-build-errors.md
@@ -313,24 +292,34 @@ files:
 - docs/agent/topics/dev-tooling-usage.md
 - docs/agent/topics/devops-ci-cd.md
 - docs/agent/topics/product-docs-deployment.md
+- docs/library-readme.adoc
 - 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/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: '