Prepare Hourleaf 1.0.5 (18)

AppStore/README.md

@@ -9,7 +9,7 @@ App Store Connect only after the matching archive is verified.
 - Platform record: iOS with an embedded watchOS companion app
 - App Store name: `Hourleaf: Ministry Hours`
 - Bundle identifier: `com.kikuai.hourleaf`
-- Source candidate: `1.0.4` (`17`)
+- Source candidate: `1.0.5` (`18`)
 - Primary language: English (U.S.)
 - Localizations: English (U.S.), Russian, Ukrainian
 - Primary category: Productivity

AppStore/metadata/en-US/description.txt

@@ -4,6 +4,8 @@ Record service or credit time in seconds, add an optional note, and review every
 
 On Apple Watch, choose service or credit, set hours and minutes with the Digital Crown, and save the entry to your iPhone.
 
+With Siri and Shortcuts, you can record a spoken number of minutes or prepare monthly report text without opening Hourleaf. The report action only reads the calculated report; it never changes entries or sends anything.
+
 Hourleaf includes:
 
 • Fast entry for service and credit time
@@ -13,6 +15,7 @@ Hourleaf includes:
 • Service-year progress toward a 600-hour goal
 • Monthly and inactivity reminders you control
 • Apple Watch entry
+• Siri and Shortcuts for voice entry and report text
 • Local backup, restore, and CSV export/import
 • English, Russian, and Ukrainian
 

AppStore/metadata/en-US/keywords.txt

@@ -1 +1 @@
-service,field,pioneer,publisher,preaching,bible,study,report,credit,tracker,volunteer,ledger
+service,field,pioneer,publisher,preaching,bible,study,report,credit,tracker,siri,shortcut

AppStore/metadata/en-US/promotional_text.txt

@@ -1 +1 @@
-Record ministry and credit time in seconds, see your service-year progress, prepare monthly reports, and add time from Apple Watch.
+Record ministry time with Siri or Apple Watch, prepare monthly reports with Shortcuts, and keep every entry private on your devices.

AppStore/metadata/en-US/release_notes.txt

@@ -1 +1 @@
-Small and medium widgets show this month's service, credit, and Bible studies; the medium widget also shows progress toward 600 hours. Siri now asks exactly how many minutes to record, and service and credit use separate reliable actions.
+Prepare a monthly report with Shortcuts without changing your records. Settings now makes it easy to share Hourleaf, leave an App Store rating, and open the guide in English, Russian, or Ukrainian.

AppStore/metadata/ru/description.txt

@@ -4,6 +4,8 @@ Hourleaf — простой и приватный способ вести учё
 
 На Apple Watch выберите служение или кредит, установите часы и минуты колёсиком Digital Crown и сохраните запись на iPhone.
 
+С помощью Siri и «Быстрых команд» можно надиктовать количество минут или подготовить текст месячного отчёта, не открывая Hourleaf. Действие отчёта только читает рассчитанный результат: оно не меняет записи и ничего не отправляет.
+
 В Hourleaf есть:
 
 • Быстрое добавление служения и кредита
@@ -13,6 +15,7 @@ Hourleaf — простой и приватный способ вести учё
 • Прогресс к цели 600 часов за служебный год
 • Настраиваемые месячные напоминания и напоминания после перерыва
 • Ввод с Apple Watch
+• Siri и «Быстрые команды» для голосового ввода и текста отчёта
 • Локальная резервная копия, восстановление, экспорт и импорт CSV
 • Русский, украинский и английский языки
 

AppStore/metadata/ru/keywords.txt

@@ -1 +1 @@
-проповедь,пионер,возвещатель,изучение,Библия,календарь,кредит,отчёт,журнал,виджет,голосом
+проповедь,пионер,возвещатель,изучение,Библия,календарь,кредит,отчёт,журнал,виджет,голосом,команды

AppStore/metadata/ru/promotional_text.txt

@@ -1 +1 @@
-Записывайте служение и кредит за секунды, следите за прогрессом служебного года, готовьте месячный отчёт и добавляйте время с Apple Watch.
+Записывайте служение через Siri или Apple Watch, готовьте месячные отчёты в «Быстрых командах» и храните записи приватно на своих устройствах.

AppStore/metadata/ru/release_notes.txt

@@ -1 +1 @@
-Малый и средний виджеты показывают служение, кредит и изучения Библии за месяц; средний также показывает прогресс к 600 часам. Siri теперь прямо спрашивает «Сколько минут?», а служение и кредит записываются отдельными надёжными действиями.
+Теперь месячный отчёт можно подготовить в «Быстрых командах», не изменяя записи. В настройках стало проще поделиться Hourleaf, оставить оценку в App Store и открыть инструкцию на русском, украинском или английском.

AppStore/metadata/uk/description.txt

@@ -4,6 +4,8 @@ Hourleaf — простий і приватний спосіб вести обл
 
 На Apple Watch виберіть служіння або кредит, установіть години та хвилини коліщатком Digital Crown і збережіть запис на iPhone.
 
+За допомогою Siri й «Команд» можна продиктувати кількість хвилин або підготувати текст місячного звіту, не відкриваючи Hourleaf. Дія звіту лише читає розрахований результат: вона не змінює записів і нічого не надсилає.
+
 У Hourleaf є:
 
 • Швидке додавання служіння та кредиту
@@ -13,6 +15,7 @@ Hourleaf — простий і приватний спосіб вести обл
 • Прогрес до цілі 600 годин за службовий рік
 • Налаштовувані місячні нагадування та нагадування після перерви
 • Введення з Apple Watch
+• Siri й «Команди» для голосового введення та тексту звіту
 • Локальна резервна копія, відновлення, експорт та імпорт CSV
 • Українська, російська й англійська мови
 

AppStore/metadata/uk/keywords.txt

@@ -1 +1 @@
-проповідь,піонер,вісник,вивчення,Біблія,календар,кредит,звіт,журнал,віджет,голосом
+проповідь,піонер,вісник,вивчення,Біблія,календар,кредит,звіт,журнал,віджет,голосом,команди

AppStore/metadata/uk/promotional_text.txt

@@ -1 +1 @@
-Записуйте служіння та кредит за лічені секунди, стежте за прогресом службового року, готуйте місячний звіт і додавайте час з Apple Watch.
+Записуйте служіння через Siri або Apple Watch, готуйте місячні звіти в «Командах» і зберігайте записи приватно на своїх пристроях.

AppStore/metadata/uk/release_notes.txt

@@ -1 +1 @@
-Малий і середній віджети показують служіння, кредит і вивчення Біблії за місяць; середній також показує прогрес до 600 годин. Siri тепер прямо запитує «Скільки хвилин?», а служіння й кредит записуються окремими надійними діями.
+Тепер місячний звіт можна підготувати в «Командах», не змінюючи записів. У налаштуваннях стало простіше поділитися Hourleaf, залишити оцінку в App Store і відкрити інструкцію українською, російською або англійською.

AppStore/release-checklist.md

@@ -1,10 +1,60 @@
 # Hourleaf delivery checklist
 
-## Active release: 1.0.4 (17)
+## Active release: 1.0.5 (18)
 
-This active section is the maintained release contract. It is superseded when
-the next version becomes the source candidate; dated receipts below remain
-immutable history.
+This active section is the maintained release contract. Dated receipts below
+remain immutable history.
+
+### Scope and source
+
+- [x] All iPhone, WidgetKit, and Watch shipping configurations use version
+      `1.0.5` build `18`.
+- [x] The read-only monthly-report Shortcut, localized Share/Rate actions,
+      Ukrainian guide routing, and delayed once-per-version review request are
+      merged to `main`.
+- [x] English, Russian, and Ukrainian metadata describes only implemented
+      behavior and passes the repository character-limit guard.
+
+### Automated verification
+
+- [x] Focused App Intent suite passes: 30 of 30 tests.
+- [x] Focused localized settings accessibility test passes in English,
+      Russian, and Ukrainian.
+- [x] Full CI passes on the exact merged tree: 531 unit/integration tests and
+      53 app-owned UI tests, with zero failures (run `33264052461`).
+- [x] Release guard, guard self-test, local installer self-test, and diff checks
+      pass.
+
+### Physical acceptance
+
+- [ ] Install the separate local-development bundle on the physical iPhone;
+      do not replace the App Store/TestFlight bundle or touch its ledger.
+- [ ] Verify Share Hourleaf, Rate Hourleaf, and Ukrainian guide routing.
+- [ ] Prepare one synthetic monthly report through Shortcuts and confirm the
+      returned text is correct and the ledger is unchanged.
+- [ ] Mark a synthetic report sent and verify the review request path does not
+      interrupt the action or repeat in the same app version. StoreKit may
+      legitimately suppress the system prompt.
+- [ ] Verify the medium Continuity widget on Mac if the nearby-iPhone gallery
+      exposes the current Hourleaf widget.
+
+### Owner-controlled distribution
+
+- [ ] Wait for the submitted `1.0.4` (`17`) review to resolve; approval and
+      public availability are separate readbacks.
+- [ ] Create and inspect the signed `1.0.5` (`18`) App Store archive only after
+      physical acceptance.
+- [ ] Upload build `18`, wait for processing, and attach it to a new version
+      only after a fresh owner-controlled release gate.
+- [ ] Save EN/RU/UK metadata and reviewer notes, submit, and verify the displayed
+      review status.
+- [ ] Publish the matching EN/RU/UK website and campaign links only when the
+      advertised build is actually available.
+
+## Submitted release: 1.0.4 (17)
+
+This section is retained as the release record for the version currently in
+App Review. It does not claim approval or public availability.
 
 ### Source and package
 

AppStore/release-monitoring.md

@@ -75,6 +75,25 @@ Convert only concrete, reproducible work into the existing Hourleaf roadmap
 Issue. Never reply as the user, promise a date, or disclose reviewer information
 without a separate owner-approved response.
 
+## Acquisition measurement
+
+Use App Store Connect campaign links and aggregate storefront metrics only.
+Hourleaf does not add an attribution SDK, device identifier, account, tracking
+pixel, or per-user event log.
+
+- Keep one campaign token per owned surface: `web-en`, `web-ru`, `web-uk`, and
+  `github`.
+- Generate the provider token in App Store Connect; never invent it. Read back
+  each final URL before publishing it in the website or README.
+- Record the public version, observation window, product-page views, first-time
+  downloads, and conversion rate in the canonical Issue. A metric is unknown
+  when Apple withholds a small cohort; do not infer zero or identify a person.
+- Compare at least seven days of organic baseline with the same window after
+  campaign links go live. Do not claim adoption from GitHub clones, CI traffic,
+  an upload, an approval, or a single owner installation.
+- Paid ads, creator outreach, and community posting require their own bounded
+  owner decision; they are not part of the default release process.
+
 ## Release closeout
 
 A release is closed only when the canonical Issue contains provider readback

AppStore/review-notes.md

@@ -4,6 +4,23 @@ This file is the maintained source for the App Review Information Notes field.
 Update it when the review path, shipped capabilities, or verified physical-device
 matrix changes. Keep private reviewer contact details only in App Store Connect.
 
+## Version 1.0.5 candidate update
+
+Build 18 adds a read-only monthly-report action for Apple Shortcuts, localized
+Share Hourleaf and Rate Hourleaf actions in Settings, and correct Ukrainian
+guide routing. The report action returns only the existing calculated report
+text, requires local device authentication, compares the ledger before and
+after reading, never changes an entry, and never sends anything. Hourleaf may
+ask for an App Store rating only after the user successfully marks a report as
+sent; the native StoreKit request waits two seconds, is cancelled if the user
+leaves the screen, and is attempted at most once per app version. This update
+adds no account, purchase, backend, third-party SDK, sensitive-data permission,
+or new data category.
+
+Physical-device acceptance and the final build-18 test matrix are still
+pending. Keep the paste-ready 1.0.4 notes below unchanged until those checks
+pass and build 18 is actually selected for submission.
+
 ## Version 1.0.4 update
 
 Build 17 adds small and medium Hourleaf widgets and makes Siri entry