test-script

Write .txt test scripts in txtar format for git-spice to verify end-to-end behavior, using golden file comparisons and ShamHub forge simulation.

• Plain text scripts for git-spice command testing in txtar format
• Verify end-to-end behavior and Git state via golden file comparisons
• Support interactive prompts and ShamHub forge simulation
• Store and compare outputs using predefined golden files

• Use `as` and `at` to freeze time and author for deterministic hashes
• Support `cmp stdout`, `cmp stderr`, `exists`, and `cmpenv` for output checks
• Use `shamhub` commands for forge simulation and login setup
• Define supporting files with `-- path/to/file --` syntax
• Update golden files with `--update` flag for auto-generation
• Follow naming convention: `<command>_<scenario>.txt`

1. 1.Create a `.txt` file in `testdata/script/` with `as` and `at` commands
2. 2.Use `gs` commands to perform actions and `cmp` to verify outputs
3. 3.Reference golden files with `$WORK/golden/filename` and update with `--update`
4. 4.Include `shamhub` setup for forge interactions if needed
5. 5.Structure script with comments, setup, commands, and supporting files