apply non-core commits

Author: DannyBen

.github/workflows/test.yml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
 
     strategy:
-      matrix: { ruby: ['3.2', '3.3', '3.4'] }
+      matrix: { ruby: ['3.2', '3.3', '3.4', '4.0'] }
 
     steps:
     - name: Checkout code

AGENTS.md

@@ -0,0 +1,5 @@
+# AGENTS.md
+
+## Notes
+
+- `CHANGELOG.md` is generated using `git changelog`; do not edit it manually.

README.md

@@ -1,5 +1,7 @@
 # Completely - Bash Completions Generator
 
+![repocard](https://repocard.dannyben.com/svg/completely.svg)
+
 Completely is a command line utility and a Ruby library that lets you generate
 bash completion scripts from simple YAML configuration.
 

spec/README.md

@@ -2,19 +2,29 @@
 
 ## Running tests
 
+You can run specs with `rspec` as usual.
+
+We recommend using [`respec`][2], which wraps common spec workflows:
+
 ```bash
-$ rspec
+rspec
 # or
-$ run spec
-# or, to run just tests in a given file
-$ run spec zsh
-# or, to run just specs tagged with :focus
-$ run spec :focus
+respec
 ```
 
 You might need to prefix the commands with `bundle exec`, depending on the way
 Ruby is installed.
 
+Useful helper shortcuts:
+
+```bash
+# script quality checks (shellcheck + shfmt generated script tests)
+respec tagged script_quality
+
+# integration behavior suite
+respec only integration
+```
+
 ## Interactive Approvals
 
 Some tests may prompt you for an interactive approval of changes. This
@@ -29,4 +39,5 @@ ZSH compatibility test is done by running the completely tester script inside a
 zsh container. This is all done automatically by `spec/completely/zsh_spec.rb`.
 
 
-[1]: https://github.com/dannyben/rspec_approvals
+[1]: https://github.com/dannyben/rspec_approvals
+[2]: https://github.com/DannyBen/respec

spec/completely/commands/install_spec.rb

@@ -52,6 +52,7 @@
 
       expect { subject.execute %w[install completely-test --dry] }
         .to output_approval('cli/install/dry')
+        .except(%r[/home/([^/]+)], '/home/USER')
     end
   end
 
@@ -64,6 +65,7 @@
       expect { subject.execute %w[install completely-test - --dry] }
         .to output_approval('cli/install/stdin-dry')
         .except(/cp [^\s]*completely-[^\s]*/, 'cp <tmpfile-path>')
+        .except(%r[/home/([^/]+)], '/home/USER')
     end
   end
 

spec/completely/commands/uninstall_spec.rb

@@ -38,7 +38,9 @@
       expect(mock_installer).not_to receive(:uninstall)
 
       expect { subject.execute %w[uninstall completely-test --dry] }
-        .to output_approval('cli/uninstall/dry').diff(20)
+        .to output_approval('cli/uninstall/dry')
+        .except(%r[/home/([^/]+)], '/home/USER')
+        .diff(20)
     end
   end