jw-meeting-scheduler

load_backup con Pydantic OrganizedAppBackup envelope + lista de PersonType del schema F51. map_person convierte PersonType.person_data.* en PersonRecord plano (gender derivado de male/female booleans separados, status derivado de publisher_baptized/unbaptized.active + statusHistory, privileges activos sólo, eligible_assignments flattened+deduped, time_away filtered, last_updated = max(updatedAt) de todos los campos Timestamped). map_schedule_week walk recursivo del SchedWeek anidado picking up dict slots {value, type, updatedAt} → AssignmentHistoryEntry con aula auto-detected del field suffix (_B→aux_class_1, _C→aux_class_2). slugify_person_id con NFD strip diacritics + lowercase. run_import pipeline con dry-run flag + compute_person_diff (added/updated/kept_local/unchanged).

SchedulerStore con dos tables: persons (PK person_id) + history (PK entry_id, índice compuesto person_id+assignment_code+meeting_date DESC para rotation queries rápidas). upsert_person con CRDT guard: si existing.last_updated ≥ rec.last_updated, no escribe (local newer wins). record_history con INSERT OR IGNORE por entry_id (idempotente). last_history_for(person, code) query para el solver. slug_table() reverse lookup display → person_id para el schedule mapper. JW_MEETING_SCHED_HOME env override del path por defecto ~/.jw-agent-toolkit/congregations/.

get_encryptor(passphrase, congregation_id) wrapea jw_core.privacy.encryption.FieldEncryptor con salt PBKDF2 derivada del congregation_id (b'jw-meeting-scheduler/v1:' + congregation_id). Si passphrase es None, FieldEncryptor cae a JW_PRIVACY_KEY env var o no-op (cleartext + warning) — mismo patrón que field_report.py. Output cifrado es str base64 Fernet token, NUNCA bytes (consistencia con field_report). Mismo passphrase + distinto congregation_id → keys distintas (verificado en tests con Fernet InvalidToken).

jw scheduler people list (Rich table del roster con privileges, eligible count, last_updated). jw scheduler person edit <slug> con --add-privilege ms/elder, --remove-privilege, --add-eligible (acepta nombre MM_BibleReading o código numérico 100), --remove-eligible, --set-status active/irregular/inactive/disfellowshipped. Cada edición toca last_updated con datetime.now(UTC).strftime('%Y-%m-%dT%H:%M:%S') para CRDT-preserving (re-import futuro respeta el edit). jw scheduler history --person <slug> --congregation <id> listing meeting_date DESC con field, code (enum name), aula, confirmed, cancelled.

AssignmentConstraints Pydantic v2 strict (extra='forbid') con congregation_id regex pattern, gap_minimum_days dict[AssignmentCode, int] (18 códigos default: 60d bible_reading, 90d speaker+TGWTalk, 45d student parts), max_assignments_per_month [1,10], pair_experienced_with_novice, require_brother_for_reading (hard constraint para reading), languages_active (≥1), aulas_active (subset de main_hall/aux_class_1/aux_class_2), weights dict[str, float] no-negativos (rotation_gap, balance_per_month, skill_match, novice_pairing, aula_distribution). constraints_io.load_constraints + write_default_constraints. Hand-rolled commented YAML dump porque PyYAML no preserva comments. CLI jw scheduler constraints {init [--force], lint, show}.

OR-Tools CpModel con variables booleanas x[person, slot] por persona elegible × slot del programa. Hard constraints: género-compatible (presidente, orador público, lectura solo hermanos bautizados), privilege-compatible (presidente reserved a ancianos/MS), pareja same-gender en AYF demonstrations, no asignación doble en una semana. Soft constraints como IntVar de penalización sumados en Minimize(): rotación gap_minimum_days hard floor, balance ≤ max_assignments_per_month, novice pairing con assistant experimentado. Output ProposedSchedWeek + infeasibility_reason estructurado por slot. Determinista con params.random_seed.