Files

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

3.0 KiB

Raw Blame History

Compass NHS — Agent Runbook

First Checks

Run these commands before any change.

git -C /home/sam/paseo/projects/compass_teams_nhs status
git -C /home/sam/paseo/projects/compass_teams_nhs log -n 5 --oneline
curl -s http://127.0.0.1:8792/health

/health must return "ok": true. It also shows the scan state and hub_api. A red scan state is real data, not a test failure.

Build and Test

The host .13 has no Go toolchain. Build and test inside golang:1.25-alpine through make. Bound every Docker command.

make test          # go test ./... in golang:1.25-alpine
make vet           # go vet ./...
make build         # build the container image

Deploy and Restart

make up            # docker compose up -d --build
make ps            # container state
make logs          # follow the service log
make restart       # restart the service only

The container is compass-teams-nhs. The image tag is compass-teams-nhs/school:0.6.2-phase6b7b.

Operate

make scan                          # fetch and parse both children
make scan SCAN_CHILD=Finn          # one child
make parse CHILD=Harry RUN=latest  # parse stored pages
make preview                       # print the briefs, send nothing
make notify                        # send the briefs from the last scan
make morning-brief                 # scan, then send (the n8n job)
make calendar CALENDAR_ARGS='push --dry-run'
make calendar CALENDAR_ARGS='status'

The send log:

docker exec compass-teams-nhs /app/school notify status

Verify

make verify-phase1                 # /health, the login, the Caddy route
make verify-phase8                 # /capabilities, /ask, /notify auth
make verify-phase8 ARGS=--send     # also deliver one real /notify message

The n8n Schedule

make n8n-key                       # dry run: print the key plan
make n8n-key APPLY=1               # create the restricted key
make n8n-import                    # dry run: print the import plan
make n8n-import APPLY=1            # import, publish and restart n8n
docker exec n8n n8n list:workflow --active=true

The workflow runs at 06:00 in Australia/Melbourne. The trigger key has a forced command and restrict. It can run one command only.

Documentation

# Publish the maps and diagrams to the LAN maps site.
~/.agents/skills/project-docs/scripts/publish-maps.sh \
  /home/sam/paseo/projects/compass_teams_nhs

# Force one Obsidian sorter pass on .27.
ssh sam@192.168.20.27 'obsidian-sort watch --once'

Rules

Read-only against the school. Never post, message or submit.
Fail loudly. Never report "nothing due" when a scan failed.
Never commit a secret. Credentials, tokens and cookies stay in environment.d/school-service.env or a Paperclip secret.
Never write personal page content into a document.
Use one commit and one push for a change. End the message with Co-Authored-By: Paperclip <noreply@paperclip.ing>.

3.0 KiB Raw Blame History