Elvis v1.0.0 — Stable POSIX call-list scraper

Elvis v1.0.0 — Stable POSIX call-list scraper

Summary

Elvis v1.0.0 is the first stable release of Elvis — a POSIX shell‑based web scraper that produces daily call lists of Australian companies from job boards. This release focuses on portability, reproducible testing, centralised configuration and audit‑friendly history handling.

Highlights

• POSIX‑first implementation (sh, POSIX awk, sed and standard Unix tools)
• SED‑first / AWK‑fallback extraction pipeline for robust parsing
• Centralised configuration in etc/elvisrc
• Deterministic test hooks: TEST_URLS_FILE, TEST_UA_FILE, TEST_SIMULATE_403
• Full documentation: PRD, architecture spec, upgrade guide, AGENT.md
• Unified logging to var/log/elvis.log and history patching in var/spool/

Notable changes

• Documentation and diagram improvements (see CHANGELOG.md)
• POSIX portability helpers and replacements (e.g. portable_epoch, portable_mktemp)
• Deterministic CI hooks and test fixtures
• Behaviour clarified: Elvis does not append to srv/company_history.txt by default; use --append-history or set APPEND_HISTORY_DEFAULT

Upgrade notes

1. Backup srv/company_history.txt, etc/elvisrc and any packaging overlays.
2. Fetch the tag and test in staging:

   git fetch --tags
   git checkout v1.0.0
   bin/elvis.sh  # use TEST_ env vars for deterministic runs