📜 rc-record.sh

Purpose

• Emit a full ritual script from the current environment, capturing session commands, environment variables, manifest states, and log snapshots.
• Provide a reproducible dump of the Rotkeeper session as a sacred record.

CLI Interface

rc-record.sh [--dry-run] [--verbose] [--help]

Supported flags:

• --help, -h Show usage information and exit.
• --dry-run Preview the record action without writing to file.
• --verbose Show detailed logs.

Workflow Steps

1. Setup & Configuration: Ensure bones/logs/ exists, parse flags.
2. State Capture: Collect Git SHA, timestamp, user, and host.
3. Write or Preview: Append to bones/logs/record.log or preview under dry-run.

Exit Codes

• 0 — Record generated successfully.
• 1 — Error writing to output or missing directories.
• 2 — Invalid flag usage or missing manifest/logs when requested.

Examples

# Record current state
./bones/scripts/rc-record.sh

# Preview recording without writing
./bones/scripts/rc-record.sh --dry-run --verbose

# Show help
./bones/scripts/rc-record.sh --help

Roadmap

• Add a --dry-run mode to preview sections without writing.
• Support JSON-formatted output for machine-readable archives.
• Integrate with CI to auto-record each pipeline run.
• Emit colored terminal banners with ritual icons.
• Automated tests (bats/shunit2) to guard capture integrity.

🛣️ Navigation

• Scripts Index
• Record Reference
• Bones Home