Files
compass_teams_nhs/scripts/calendar-push.sh
Sam Rolfe 047af0f31d Phase 6b/7b: per-child decoded periods, separate brief blocks, idempotent calendar (AUD-119)
- Parse each child's own "Today" day widget for the timetable (FR-16); drop the
  school-wide week calendar's lesson grid and clean the leaked routine rows.
- Add the editable codes map (FR-17): subjects, rooms, teachers and period
  labels, seeded, an unknown code falls back to the raw code; `school codes` CLI.
- Brief: Finn's block first, then Harry's, four sections always present (FR-9);
  periods decoded into plain English; the undated tail is one counted line (FR-18).
- Calendar: write periods + work due + work overdue + major events, per child,
  on every pass. Identity is the stable per-item key, so a re-run never re-inserts
  (FR-8). morning-brief.sh now runs scan -> calendar push -> notify.
- Day-widget labels are 12-hour: 1-6 read as PM, fixing afternoon periods.

Proven live on .13: image 0.6.2-phase6b7b; both children's briefs decoded and
separate; 35 events in calendar.school; runs 2 and 3 of the scan added nothing.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-10-16 10:25:55 +11:00

62 lines
2.4 KiB
Bash
Executable File

#!/usr/bin/env bash
# Phase 6: write important school events to Sam's Home Assistant calendar and
# read the calendar back (AGENTS.md §4 FR-8, §11 Phase 6).
#
# The school stays read-only. The only write is to the calendar. The Home
# Assistant token comes from the environment or from the service env file and is
# never printed.
#
# Usage:
# scripts/calendar-push.sh entities
# scripts/calendar-push.sh status
# scripts/calendar-push.sh push [--child Harry] [--dry-run]
# scripts/calendar-push.sh events [--days 14]
#
# Environment overrides:
# IMAGE image tag (default 0.6.2-phase6b7b)
# VOLUME SQLite volume (default compass-teams-nhs_compass-teams-nhs-data)
# ENV_FILE HA config source (default environment.d/school-service.env)
# SCHOOL_TIMEZONE family timezone (default Australia/Sydney)
# SCHOOL_HA_URL Home Assistant base URL (no default; required)
# SCHOOL_HA_TOKEN long-lived access token (no default; required)
# SCHOOL_HA_CALENDAR_ENTITY calendar entity id (no default; required)
# TIMEOUT docker command timeout (default 300)
set -euo pipefail
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
IMAGE="${IMAGE:-compass-teams-nhs/school:0.6.2-phase6b7b}"
VOLUME="${VOLUME:-compass-teams-nhs_compass-teams-nhs-data}"
ENV_FILE="${ENV_FILE:-$REPO_ROOT/environment.d/school-service.env}"
SCHOOL_TIMEZONE="${SCHOOL_TIMEZONE:-Australia/Sydney}"
TIMEOUT="${TIMEOUT:-300}"
# The real service env file is gitignored. Take only the calendar variables from
# it, so the service's bcrypt hash (which contains "$$") is never re-expanded.
if [[ -f "$ENV_FILE" ]]; then
while IFS= read -r line; do
case "$line" in
SCHOOL_HA_URL=*|SCHOOL_HA_TOKEN=*|SCHOOL_HA_CALENDAR_ENTITY=*|SCHOOL_HA_INSECURE=*|SCHOOL_HA_TIMEOUT=*)
key="${line%%=*}"
val="${line#*=}"
if [[ -z "${!key:-}" ]]; then
export "$key=$val"
fi
;;
esac
done < "$ENV_FILE"
fi
if [[ $# -eq 0 ]]; then
echo "usage: scripts/calendar-push.sh entities|status|push|events [options]" >&2
exit 2
fi
exec timeout "$TIMEOUT" docker run --rm --network host \
-v "$VOLUME:/data" \
-e SCHOOL_DB_PATH=/data/school.db \
-e SCHOOL_TIMEZONE="$SCHOOL_TIMEZONE" \
-e SCHOOL_HA_URL -e SCHOOL_HA_TOKEN -e SCHOOL_HA_CALENDAR_ENTITY \
-e SCHOOL_HA_INSECURE -e SCHOOL_HA_TIMEOUT \
"$IMAGE" calendar "$@"