CHARGING MESSAGES — EARLY RELEASE 1

This is the spoken-text edition, separate from Charging Sounds. It uses Apple Speak Text with an available device voice. The exact conversational Siri voice is not guaranteed. No audio files, external settings folder, network request, or API key is required.

STATUS: Seven production shortcuts installed and organized on the owner's Duo; all five old sound routes off and all five spoken replacements on. All five production routes completed manual calls after their helper permissions were approved; the three milestone routes were run connected to power. Owner confirmed hearing the manual connection preview. Exact spoken percentage and other phrases remain unaccepted. Actual Sleep and Do Not Disturb manual runs completed; owner silence confirmation is pending, and the original Available Focus was restored. Fourteen native fixture cases passed; these do not prove physical triggers, actual spoken percentage, real Focus modes, threshold crossings, locked playback or MagSafe. Powered milestone calls and first-run helper permissions are complete on the owner's Duo. Physical and acoustic acceptance remain pending. This is an early release with the device checks above still open. Charging Sounds remains a separate download; this edition does not replace its audio files.

INSTALL
1. Unzip the kit in Files. Add Speak Charging Message first, then Test Charging Messages, then the five Spoken Charging trigger files. Keep their names.
2. In the Shortcuts app, create a Charging Messages folder and put all seven shortcuts there.
3. Edit Speak Charging Message. The first Dictionary has six message values. Tap and change the message values (sentences), keeping the six keys exactly as they are: Low battery, Connected, 50 percent, 80 percent, Fully charged, Disconnected. Anywhere you type {battery}, the current battery percentage will be inserted. For example, Power connected. I am at {battery} percent. speaks Power connected. I am at 67 percent. at 67%. Omit {battery} for a fixed phrase. Close the editor to save, then preview again.
4. The List below that Dictionary contains the Focus names which should suppress speech: Sleep and Do Not Disturb by default. Add/remove exact Focus names as desired. Matching ignores case. An empty list excludes no Focus modes.
5. Scroll near the bottom of Speak Charging Message and expand the final Speak Text action using its disclosure arrow. Choose Language first, then Voice, and adjust Rate and Pitch. This setting controls all five routes. Changing the Siri voice in Settings does not guarantee Speak Text will follow it. The newest Siri voice may not appear in this action. A voice may need to be downloaded on the phone. Leave Wait Until Finished on. This download initially selects English (United States), Siri Voice 4 where available and does not override the phone volume.
6. Run Test Charging Messages. Choose each of the six events and allow the helper to run when asked. If Run Shortcut is unselected or cannot resolve, select Speak Charging Message in that action. Repeat this check for each of the five triggers. Connect the phone to power before manually testing 50%, 80% and full-charge routes: their charger guard otherwise returns without invoking the helper, so its first-run permission is not cleared. Allow the helper from each milestone route while connected; do not bypass the guard.

SWITCH EDITIONS
After testing the new helper, go to Library > Automation. Disable the five old sound-pack automations: Charging Connected, Charging Disconnected, Charging at 50 Percent, Charging at 80 Percent, Charging Fully Charged. Preserve the shortcuts and audio.
Enable only their five Spoken Charging counterparts. Imported triggers may initially be off; confirm Run Immediately and locked-running settings on the phone. Do not enable both editions for the same event. To revert, turn off all five Spoken Charging automations, then turn the old five back on.

BEHAVIOR
Spoken Charging Connected: battery below 20 -> Low battery; 20 or above -> Connected.
Spoken Charging Disconnected: Disconnected message.
Spoken Charging at 50 Percent: reaches exactly 50, connected to power -> 50 percent message.
Spoken Charging at 80 Percent: reaches exactly 80, connected to power -> 80 percent message.
Spoken Charging Fully Charged: reaches exactly 100, connected to power -> Fully charged message.
All paths use the shared Focus exclusions before speaking. There are no randomized messages.

TEST ON THE PHONE
Use the manual tester for the six phrases; it previews an event and speaks the ACTUAL battery reading. It does not simulate a threshold. Manually running a milestone shortcut checks the charger guard and phrase route, but does not prove a real battery crossing.
Confirm a single disconnect and connect announcement with the cable. Test permitted Focus, Sleep, Do Not Disturb and no Focus. Test locked-phone playback. Verify actual 50/80/100 crossings while connected when practical. MagSafe uses the same charger trigger but needs its own physical check.

Apple's own charging chime is separate. Focus exclusions stop new custom announcements; they do not stop an announcement already speaking. Bluetooth/AirPlay routes and volume can affect where you hear it.