Always Start Here

Update-processing commands are always run from the top-levelsagp repository.

cd /Users/brash/sagp

Processing a Membership Update

1. Save the attached JSON file, usually to the Downloads folder.
2. Open Terminal.
3. Change to the top-level repository:

cd /Users/brash/sagp

Run:

python3 -m scripts.process_membership_update ~/Downloads/<membership_update_file>.json

Review the proposed changes. If everything looks correct, type:

YES

The script will automatically update the membership database, regenerate website data, commit, push, deploy, and update the umbrella repository.

Processing a New Member Request

Save the attached request file, then start from the umbrella repository:

cd /Users/brash/sagp

Run:

python3 -m scripts.process_membership_create ~/Downloads/<membership_create_file>.json

Review the proposed record, derived status, and duplicate-check results. If everything is correct, type:

YES

The script will create the member, regenerate and build the website, commit and push its data, watch deployment, and update the umbrella repository.

Processing a Publication Update

1. Save the attached JSON file, usually to the Downloads folder.
2. Open Terminal.
3. Change to the top-level repository:

cd /Users/brash/sagp

Run:

python3 -m scripts.process_publication_update ~/Downloads/<publication_update_file>.json

Review the proposed changes. If everything looks correct, type:

YES

The script will automatically update canonical YAML, regenerate the publishing index, rebuild the website, commit, push, deploy, and update the umbrella repository.

Creating a New Event

1. Obtain the finalized Microsoft Word (.docx) version of the event announcement.
2. Open Terminal.
3. Change to the top-level SAGP repository:

cd /Users/brash/sagp

Generate a draft Event YAML:

python3 -m scripts.create_event_from_docx_ai \
~/Downloads/<event_document>.docx \
--type annual_conference \
--year 2027

The generated draft YAML will be written to:

sagp_website/content/events/annual_conference/2027.draft.yaml

Preview the draft website locally:

cd sagp_website
npm run dev

Then open:

http://localhost:4321/executive/draft-event-preview/annual-conference/2027/

Edit the draft YAML as needed and refresh the preview until satisfied. Once approved, promote the draft to canonical YAML and publish using the normal publication workflow.

If a Safety Check Fails