[feat] add example scripts for transcription, model downloading, and updates; improve documentation with guides for CI, packaging, and development

examples/transcribe_file.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Transcribe an audio/video file to JSON and SRT into ./output
+# Requires a model; first run may prompt to download.
+
+BIN=${BIN:-./target/release/polyscribe}
+INPUT=${1:-samples/example.mp3}
+OUTDIR=${OUTDIR:-output}
+
+mkdir -p "$OUTDIR"
+"$BIN" -v -o "$OUTDIR" "$INPUT"
+echo "Done. See $OUTDIR for JSON/SRT files."