commentail 0.2.0__tar.gz → 1.0.0__tar.gz

{commentail-0.2.0 → commentail-1.0.0}/CHANGELOG.md

@@ -3,6 +3,16 @@
 Each release records changes relative to the previous version. Upgrade notes
 describe changes that an existing installation needs to review.
 
+## [1.0.0] — 2026-10-19 · Stable
+
+The feature set is frozen at 0.2.0 Beta. This release introduces the documented
+stable API and compatibility policy; runtime, dependencies and migration files
+are unchanged from 0.2.0. Live-site verification of published 0.2.0 is recorded
+in the [verification guide](docs/wiki/Example-and-testing.md#reported-live-site-verification-020).
+The documented integration surface now follows semantic versioning and the
+stated deprecation policy. Direct upgrade and backup-restoration rehearsals
+cover 0.1.0 and 0.2.0 on SQLite and PostgreSQL 16.
+
 ## [0.2.0] — 2026-10-19 · Beta
 
 Changes from **0.1.1 → 0.2.0**.
@@ -113,4 +123,5 @@ See [0.1.0 release notes](docs/releases/0.1.0.md).
 [0.1.1]: https://github.com/hardcodd/Commentail/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/hardcodd/Commentail/releases/tag/v0.1.0
 
+[1.0.0]: https://github.com/hardcodd/Commentail/compare/v0.2.0...v1.0.0
 [0.2.0]: https://github.com/hardcodd/Commentail/compare/v0.1.1...v0.2.0

{commentail-0.2.0/commentail.egg-info → commentail-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commentail
-Version: 0.2.0
+Version: 1.0.0
 Summary: Self-hosted Wagtail comments with moderation, verified guests and threaded replies
 License-Expression: MIT
 Project-URL: Source, https://github.com/hardcodd/Commentail
@@ -8,7 +8,7 @@ Project-URL: Issues, https://github.com/hardcodd/Commentail/issues
 Project-URL: Documentation, https://github.com/hardcodd/Commentail/wiki
 Project-URL: Changelog, https://github.com/hardcodd/Commentail/blob/main/CHANGELOG.md
 Project-URL: Funding, https://pay.cloudtips.ru/p/f92ee349
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Framework :: Django :: 5.2
 Classifier: Framework :: Django :: 6.0
 Classifier: Framework :: Django :: 6.1
@@ -34,6 +34,8 @@ Dynamic: license-file
 
 Moderated discussions, verified guests and inline replies — styled by your site.
 
+**Current release: [1.0.0](https://github.com/hardcodd/Commentail/releases/tag/v1.0.0)** · [PyPI](https://pypi.org/project/commentail/1.0.0/)
+
 [![Tests and distributions](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml)
 [![Django Packages · Commentail](https://img.shields.io/badge/Django%20Packages-Commentail-0C4B33.svg)](https://djangopackages.org/packages/p/commentail/)
 
@@ -53,10 +55,10 @@ The widget inherits your site's typography and colors. CSS custom properties,
 replaceable templates and Python callbacks let you adapt it without a frontend
 framework or an external comments platform.
 
-> **0.2.0 Beta** adds recent comments, six languages,
-> HTML emails and indexed database reads.
+> **1.0.0** starts the stable API and compatibility policy with the
+> feature set of 0.2.0 Beta, including recent comments, six languages and HTML emails.
 > [Version-to-version changelog](https://github.com/hardcodd/Commentail/blob/main/CHANGELOG.md) · [Roadmap](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Roadmap.md).
-> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md).
+> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md).
 
 ## Why Commentail?
 
@@ -76,6 +78,8 @@ Published comments include **Schema.org Comment microdata and JSON-LD**, using
 the visible text and author name. Choose either format or disable output in Python.
 [Structured-data guide →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Structured-data.md)
 
+From **1.0.0**, documented integration contracts follow the [stable API and compatibility policy](docs/wiki/Stability.md).
+
 ## Compatibility
 
 | Component | Version / requirement |
@@ -87,7 +91,7 @@ the visible text and author name. Choose either format or disable output in Pyth
 | Frontend | Django templates, optional progressive JavaScript |
 | License | [MIT](https://github.com/hardcodd/Commentail/blob/main/LICENSE) |
 
-This table describes the 0.2.0 Beta release. CI defines all five framework
+This table describes the 1.0.0 release. CI defines all five framework
 pairs on Python 3.12, 3.13 and 3.14 with both databases (30 combinations).
 Package bounds are `Wagtail>=7.4.3,<8.1` and `Django>=5.2,<6.2`; only the pairs
 listed above are supported. Wagtail 7.4 with Django 6.1 is outside this matrix.
@@ -114,15 +118,15 @@ Documentation remains in English and Russian.
 In your site's virtual environment, install the release:
 
 ```sh
-python -m pip install commentail==0.2.0
+python -m pip install commentail==1.0.0
 ```
 
 For the optional PostgreSQL driver, use
-`python -m pip install 'commentail[postgres]==0.2.0'`.
+`python -m pip install 'commentail[postgres]==1.0.0'`.
 You can also extract the source distribution and run `python -m pip install .` in its root.
-When upgrading from 0.1.1, review the
-[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md),
-including migration `0014_reading_indexes` and email overrides. For older
+When upgrading, review the
+[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md),
+including the 0.2.0 index migration and email overrides when coming from 0.1.1. For older
 installations, also review the [0.1.1 notes](docs/releases/0.1.1.md). The 0.1.0 package retains
 its original Wagtail 7.4 and Django 5.2 limits.
 
@@ -222,7 +226,7 @@ cover the same topics. Start with the task you need:
 
 ## Release scope and verification
 
-[0.2.0 Beta release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md) describe the changes and upgrade steps;
+[1.0.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md) describe the changes and upgrade steps;
 [0.1.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.1.0.md) preserve the initial release contract.
 The source distribution includes the runnable Wagtail example, tests and
 guides; the wheel includes the runtime, translations, templates and static assets.
@@ -230,11 +234,12 @@ guides; the wheel includes the runtime, translations, templates and static asset
 The CI workflow defines 30 framework/Python/database combinations, JavaScript, lint, migration drift,
 translations and source/wheel installation. Browser checks covered installed Safari,
 Chrome, Yandex Browser and Firefox with and without JS, plus selected VoiceOver
-scenarios and a phone. Previous major browser versions remain unverified; this is
-not an exhaustive accessibility or device certification.
+scenarios and a phone. Historical checks also covered Chrome 142 on macOS and Windows ARM64 and Firefox
+140 ESR on Windows ARM64; Chrome x64 used Windows emulation. This is not an
+exhaustive accessibility or device certification.
 
 There is no separate REST API, rich-text editor, uploads, likes, reports or live
-updates in 0.2.0. SMTP retries can duplicate mail after an uncertain delivery result.
+updates in 1.0.0. SMTP retries can duplicate mail after an uncertain delivery result.
 Host-specific themes, access rules and email delivery need their own acceptance checks.
 
 ## Support Commentail

{commentail-0.2.0 → commentail-1.0.0}/README.md

@@ -6,6 +6,8 @@
 
 Moderated discussions, verified guests and inline replies — styled by your site.
 
+**Current release: [1.0.0](https://github.com/hardcodd/Commentail/releases/tag/v1.0.0)** · [PyPI](https://pypi.org/project/commentail/1.0.0/)
+
 [![Tests and distributions](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml)
 [![Django Packages · Commentail](https://img.shields.io/badge/Django%20Packages-Commentail-0C4B33.svg)](https://djangopackages.org/packages/p/commentail/)
 
@@ -25,10 +27,10 @@ The widget inherits your site's typography and colors. CSS custom properties,
 replaceable templates and Python callbacks let you adapt it without a frontend
 framework or an external comments platform.
 
-> **0.2.0 Beta** adds recent comments, six languages,
-> HTML emails and indexed database reads.
+> **1.0.0** starts the stable API and compatibility policy with the
+> feature set of 0.2.0 Beta, including recent comments, six languages and HTML emails.
 > [Version-to-version changelog](https://github.com/hardcodd/Commentail/blob/main/CHANGELOG.md) · [Roadmap](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Roadmap.md).
-> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md).
+> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md).
 
 ## Why Commentail?
 
@@ -48,6 +50,8 @@ Published comments include **Schema.org Comment microdata and JSON-LD**, using
 the visible text and author name. Choose either format or disable output in Python.
 [Structured-data guide →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Structured-data.md)
 
+From **1.0.0**, documented integration contracts follow the [stable API and compatibility policy](docs/wiki/Stability.md).
+
 ## Compatibility
 
 | Component | Version / requirement |
@@ -59,7 +63,7 @@ the visible text and author name. Choose either format or disable output in Pyth
 | Frontend | Django templates, optional progressive JavaScript |
 | License | [MIT](https://github.com/hardcodd/Commentail/blob/main/LICENSE) |
 
-This table describes the 0.2.0 Beta release. CI defines all five framework
+This table describes the 1.0.0 release. CI defines all five framework
 pairs on Python 3.12, 3.13 and 3.14 with both databases (30 combinations).
 Package bounds are `Wagtail>=7.4.3,<8.1` and `Django>=5.2,<6.2`; only the pairs
 listed above are supported. Wagtail 7.4 with Django 6.1 is outside this matrix.
@@ -86,15 +90,15 @@ Documentation remains in English and Russian.
 In your site's virtual environment, install the release:
 
 ```sh
-python -m pip install commentail==0.2.0
+python -m pip install commentail==1.0.0
 ```
 
 For the optional PostgreSQL driver, use
-`python -m pip install 'commentail[postgres]==0.2.0'`.
+`python -m pip install 'commentail[postgres]==1.0.0'`.
 You can also extract the source distribution and run `python -m pip install .` in its root.
-When upgrading from 0.1.1, review the
-[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md),
-including migration `0014_reading_indexes` and email overrides. For older
+When upgrading, review the
+[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md),
+including the 0.2.0 index migration and email overrides when coming from 0.1.1. For older
 installations, also review the [0.1.1 notes](docs/releases/0.1.1.md). The 0.1.0 package retains
 its original Wagtail 7.4 and Django 5.2 limits.
 
@@ -194,7 +198,7 @@ cover the same topics. Start with the task you need:
 
 ## Release scope and verification
 
-[0.2.0 Beta release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md) describe the changes and upgrade steps;
+[1.0.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md) describe the changes and upgrade steps;
 [0.1.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.1.0.md) preserve the initial release contract.
 The source distribution includes the runnable Wagtail example, tests and
 guides; the wheel includes the runtime, translations, templates and static assets.
@@ -202,11 +206,12 @@ guides; the wheel includes the runtime, translations, templates and static asset
 The CI workflow defines 30 framework/Python/database combinations, JavaScript, lint, migration drift,
 translations and source/wheel installation. Browser checks covered installed Safari,
 Chrome, Yandex Browser and Firefox with and without JS, plus selected VoiceOver
-scenarios and a phone. Previous major browser versions remain unverified; this is
-not an exhaustive accessibility or device certification.
+scenarios and a phone. Historical checks also covered Chrome 142 on macOS and Windows ARM64 and Firefox
+140 ESR on Windows ARM64; Chrome x64 used Windows emulation. This is not an
+exhaustive accessibility or device certification.
 
 There is no separate REST API, rich-text editor, uploads, likes, reports or live
-updates in 0.2.0. SMTP retries can duplicate mail after an uncertain delivery result.
+updates in 1.0.0. SMTP retries can duplicate mail after an uncertain delivery result.
 Host-specific themes, access rules and email delivery need their own acceptance checks.
 
 ## Support Commentail

{commentail-0.2.0 → commentail-1.0.0}/README.ru.md

@@ -6,6 +6,8 @@
 
 Модерация обсуждений, подтверждённые гости и ответы рядом с комментарием — в стиле вашего сайта.
 
+**Текущая версия: [1.0.0](https://github.com/hardcodd/Commentail/releases/tag/v1.0.0)** · [PyPI](https://pypi.org/project/commentail/1.0.0/)
+
 [![Tests and distributions](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml)
 [![Django Packages · Commentail](https://img.shields.io/badge/Django%20Packages-Commentail-0C4B33.svg)](https://djangopackages.org/packages/p/commentail/)
 
@@ -25,10 +27,10 @@ Commentail — библиотека комментариев Django для **Wag
 Python callbacks позволяют адаптировать его без фронтенд-фреймворка или
 внешней платформы комментариев.
 
-> **0.2.0 Beta:** последние комментарии,
-> шесть языков, HTML-письма и оптимизация запросов с новыми индексами.
+> **1.0.0:** стабильный контракт API и правила совместимости с составом
+> 0.2.0 Beta: последние комментарии, шесть языков и HTML-письма.
 > [Изменения между версиями](https://github.com/hardcodd/Commentail/blob/main/CHANGELOG.md) · [Планы развития](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Roadmap.md).
-> [Изменения и обновление](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md).
+> [Изменения и обновление](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md).
 
 ## Зачем Commentail?
 
@@ -50,6 +52,8 @@ Python callbacks позволяют адаптировать его без фр
 отключить вывод.
 [Руководство по структурированным данным →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Structured-data.md)
 
+Начиная с **1.0.0**, документированные контракты интеграции подчиняются [правилам стабильного API и совместимости](docs/wiki/Stability.md).
+
 ## Совместимость
 
 | Компонент | Версия / требование |
@@ -61,7 +65,7 @@ Python callbacks позволяют адаптировать его без фр
 | Фронтенд | Шаблоны Django, необязательный JavaScript для постепенного улучшения интерфейса |
 | Лицензия | [MIT](https://github.com/hardcodd/Commentail/blob/main/LICENSE) |
 
-Таблица описывает выпуск 0.2.0 Beta. CI определяет все пять пар фреймворков
+Таблица описывает выпуск 1.0.0. CI определяет все пять пар фреймворков
 на Python 3.12, 3.13 и 3.14 с обеими базами данных — всего 30 сочетаний.
 Границы зависимостей пакета: `Wagtail>=7.4.3,<8.1` и `Django>=5.2,<6.2`;
 поддерживаются только перечисленные пары. Wagtail 7.4 с Django 6.1 не входит
@@ -89,15 +93,15 @@ Python callbacks позволяют адаптировать его без фр
 В виртуальном окружении сайта установите выпуск:
 
 ```sh
-python -m pip install commentail==0.2.0
+python -m pip install commentail==1.0.0
 ```
 
 Для необязательного драйвера PostgreSQL используйте
-`python -m pip install 'commentail[postgres]==0.2.0'`.
+`python -m pip install 'commentail[postgres]==1.0.0'`.
 Также можно распаковать исходный архив и выполнить `python -m pip install .` в его корне.
-При обновлении с 0.1.1 прочитайте
-[инструкцию по обновлению](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md),
-включая миграцию `0014_reading_indexes` и переопределения писем. Для более старых
+При обновлении прочитайте
+[инструкцию по обновлению](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md),
+включая миграцию индексов 0.2.0 и переопределения писем при переходе с 0.1.1. Для более старых
 установок также прочитайте [примечания к 0.1.1](docs/releases/0.1.1.md). Пакет 0.1.0 сохраняет
 исходные ограничения Wagtail 7.4 и Django 5.2.
 
@@ -202,7 +206,7 @@ Django через `OBJECT_ADAPTERS`. Технические настройки
 
 ## Границы выпуска и проверок
 
-[Примечания к выпуску 0.2.0 Beta](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md)
+[Примечания к выпуску 1.0.0](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md)
 описывают изменения и обновление;
 [примечания к 0.1.0](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.1.0.md)
 сохраняют исходный контракт выпуска. Архив исходников включает запускаемый
@@ -213,10 +217,11 @@ CI определяет 30 сочетаний фреймворков, Python и
 линтеров, изменений моделей без миграций, переводов и установки из исходников/wheel.
 Браузерные проверки охватили установленные Safari, Chrome, Яндекс Браузер и
 Firefox с JavaScript и без него, отдельные сценарии VoiceOver и телефон.
-Предыдущие основные версии браузеров не проверены; это не исчерпывающая
+Дополнительно проверены Chrome 142 на macOS и Windows ARM64 и Firefox 140 ESR
+на Windows ARM64; Chrome x64 работал через эмуляцию Windows. Это не исчерпывающая
 сертификация доступности или устройств.
 
-В 0.2.0 нет отдельного REST API, редактора форматированного текста, загрузки
+В 1.0.0 нет отдельного REST API, редактора форматированного текста, загрузки
 файлов, лайков, жалоб и обновлений в реальном времени. Повторные попытки SMTP
 могут дублировать письма после неопределённого результата доставки. Темы сайта,
 правила доступа и доставка почты требуют собственной приёмки.

{commentail-0.2.0 → commentail-1.0.0/commentail.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commentail
-Version: 0.2.0
+Version: 1.0.0
 Summary: Self-hosted Wagtail comments with moderation, verified guests and threaded replies
 License-Expression: MIT
 Project-URL: Source, https://github.com/hardcodd/Commentail
@@ -8,7 +8,7 @@ Project-URL: Issues, https://github.com/hardcodd/Commentail/issues
 Project-URL: Documentation, https://github.com/hardcodd/Commentail/wiki
 Project-URL: Changelog, https://github.com/hardcodd/Commentail/blob/main/CHANGELOG.md
 Project-URL: Funding, https://pay.cloudtips.ru/p/f92ee349
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Framework :: Django :: 5.2
 Classifier: Framework :: Django :: 6.0
 Classifier: Framework :: Django :: 6.1
@@ -34,6 +34,8 @@ Dynamic: license-file
 
 Moderated discussions, verified guests and inline replies — styled by your site.
 
+**Current release: [1.0.0](https://github.com/hardcodd/Commentail/releases/tag/v1.0.0)** · [PyPI](https://pypi.org/project/commentail/1.0.0/)
+
 [![Tests and distributions](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml)
 [![Django Packages · Commentail](https://img.shields.io/badge/Django%20Packages-Commentail-0C4B33.svg)](https://djangopackages.org/packages/p/commentail/)
 
@@ -53,10 +55,10 @@ The widget inherits your site's typography and colors. CSS custom properties,
 replaceable templates and Python callbacks let you adapt it without a frontend
 framework or an external comments platform.
 
-> **0.2.0 Beta** adds recent comments, six languages,
-> HTML emails and indexed database reads.
+> **1.0.0** starts the stable API and compatibility policy with the
+> feature set of 0.2.0 Beta, including recent comments, six languages and HTML emails.
 > [Version-to-version changelog](https://github.com/hardcodd/Commentail/blob/main/CHANGELOG.md) · [Roadmap](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Roadmap.md).
-> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md).
+> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md).
 
 ## Why Commentail?
 
@@ -76,6 +78,8 @@ Published comments include **Schema.org Comment microdata and JSON-LD**, using
 the visible text and author name. Choose either format or disable output in Python.
 [Structured-data guide →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Structured-data.md)
 
+From **1.0.0**, documented integration contracts follow the [stable API and compatibility policy](docs/wiki/Stability.md).
+
 ## Compatibility
 
 | Component | Version / requirement |
@@ -87,7 +91,7 @@ the visible text and author name. Choose either format or disable output in Pyth
 | Frontend | Django templates, optional progressive JavaScript |
 | License | [MIT](https://github.com/hardcodd/Commentail/blob/main/LICENSE) |
 
-This table describes the 0.2.0 Beta release. CI defines all five framework
+This table describes the 1.0.0 release. CI defines all five framework
 pairs on Python 3.12, 3.13 and 3.14 with both databases (30 combinations).
 Package bounds are `Wagtail>=7.4.3,<8.1` and `Django>=5.2,<6.2`; only the pairs
 listed above are supported. Wagtail 7.4 with Django 6.1 is outside this matrix.
@@ -114,15 +118,15 @@ Documentation remains in English and Russian.
 In your site's virtual environment, install the release:
 
 ```sh
-python -m pip install commentail==0.2.0
+python -m pip install commentail==1.0.0
 ```
 
 For the optional PostgreSQL driver, use
-`python -m pip install 'commentail[postgres]==0.2.0'`.
+`python -m pip install 'commentail[postgres]==1.0.0'`.
 You can also extract the source distribution and run `python -m pip install .` in its root.
-When upgrading from 0.1.1, review the
-[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md),
-including migration `0014_reading_indexes` and email overrides. For older
+When upgrading, review the
+[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md),
+including the 0.2.0 index migration and email overrides when coming from 0.1.1. For older
 installations, also review the [0.1.1 notes](docs/releases/0.1.1.md). The 0.1.0 package retains
 its original Wagtail 7.4 and Django 5.2 limits.
 
@@ -222,7 +226,7 @@ cover the same topics. Start with the task you need:
 
 ## Release scope and verification
 
-[0.2.0 Beta release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.2.0.md) describe the changes and upgrade steps;
+[1.0.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md) describe the changes and upgrade steps;
 [0.1.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.1.0.md) preserve the initial release contract.
 The source distribution includes the runnable Wagtail example, tests and
 guides; the wheel includes the runtime, translations, templates and static assets.
@@ -230,11 +234,12 @@ guides; the wheel includes the runtime, translations, templates and static asset
 The CI workflow defines 30 framework/Python/database combinations, JavaScript, lint, migration drift,
 translations and source/wheel installation. Browser checks covered installed Safari,
 Chrome, Yandex Browser and Firefox with and without JS, plus selected VoiceOver
-scenarios and a phone. Previous major browser versions remain unverified; this is
-not an exhaustive accessibility or device certification.
+scenarios and a phone. Historical checks also covered Chrome 142 on macOS and Windows ARM64 and Firefox
+140 ESR on Windows ARM64; Chrome x64 used Windows emulation. This is not an
+exhaustive accessibility or device certification.
 
 There is no separate REST API, rich-text editor, uploads, likes, reports or live
-updates in 0.2.0. SMTP retries can duplicate mail after an uncertain delivery result.
+updates in 1.0.0. SMTP retries can duplicate mail after an uncertain delivery result.
 Host-specific themes, access rules and email delivery need their own acceptance checks.
 
 ## Support Commentail

{commentail-0.2.0 → commentail-1.0.0}/commentail.egg-info/SOURCES.txt

@@ -119,6 +119,7 @@ docs/assets/support-qr.png
 docs/releases/0.1.0.md
 docs/releases/0.1.1.md
 docs/releases/0.2.0.md
+docs/releases/1.0.0.md
 docs/wiki/Callbacks.md
 docs/wiki/Changelog.md
 docs/wiki/Configuration.md
@@ -135,13 +136,16 @@ docs/wiki/Recent-comments.md
 docs/wiki/Release-0.1.0.md
 docs/wiki/Release-0.1.1.md
 docs/wiki/Release-0.2.0.md
+docs/wiki/Release-1.0.0.md
 docs/wiki/Replies-and-editing.md
 docs/wiki/Roadmap.md
 docs/wiki/Rules-and-CSV.md
 docs/wiki/Security-and-privacy.md
+docs/wiki/Stability.md
 docs/wiki/Structured-data.md
 docs/wiki/Styling.md
 docs/wiki/Support.md
+docs/wiki/Template-contract.md
 docs/wiki/Templates.md
 docs/wiki/Troubleshooting.md
 docs/wiki/_Footer.md

commentail-1.0.0/docs/releases/1.0.0.md

@@ -0,0 +1,56 @@
+# Commentail 1.0.0
+
+**19 October 2026 · Stable · MIT**
+
+The feature set is frozen at published 0.2.0 Beta. This release starts the
+[stable API and compatibility policy](../wiki/Stability.md); it introduces no
+runtime changes, new dependencies or database migrations beyond 0.2.0.
+Install from [PyPI](https://pypi.org/project/commentail/1.0.0/); archives and checksums
+are available in the [GitHub release](https://github.com/hardcodd/Commentail/releases/tag/v1.0.0).
+
+## Included
+
+Self-hosted Page/object discussions; Site/Page settings; site accounts and
+email-verified guests; four moderation policies; threaded replies and moderated
+author edits; protected links and per-comment unsubscribe; database mail queue;
+custom templates, callbacks, CAPTCHA and object adapters; structured data;
+recent-comment selection with host markup; six UI/email languages; HTML/plain-text
+emails; and indexed database reads. See the [0.2.0 notes](0.2.0.md) for its additions.
+Most-discussed threads remain deferred.
+
+## Upgrade
+
+Back up the database, media, host settings/templates, `SECRET_KEY` and exact
+versions. Rehearse with `python -m pip install --upgrade commentail==1.0.0`
+in a restored test environment. Keep rehearsal mail local.
+
+- From 0.2.0: no Commentail schema migration is added. Run normal `migrate`,
+  `check` and `collectstatic --noinput`; verify existing host overrides and queues.
+- From 0.1.0 or 0.1.1: also follow the [0.1.1](0.1.1.md) and
+  [0.2.0](0.2.0.md) upgrade notes. Migration `0014_reading_indexes` builds indexes
+  and SQLite remakes the rate-event table. Measure migration cost on representative
+  data and plan a maintenance window where needed.
+- Restore pre-upgrade and post-upgrade backups independently. Verify old tokens,
+  pending revisions, permissions, settings, subscriptions and queued mail; then
+  exercise new writes and local delivery. A wheel downgrade alone is not recovery.
+
+## Verification
+
+Candidate verification and acceptance on an integrating site are separate. Check
+the host theme, access rules, email delivery and scheduled worker on that site.
+An owner-supplied report dated 19 October 2026 covers published 0.2.0 on a live
+integrating site: guest confirmation/editing/moderation, Gmail/Yandex delivery,
+reply notifications, unsubscribe, upgrade/restoration and 24 negative token/CSRF
+cases. [Verification scope and observations](../wiki/Example-and-testing.md#reported-live-site-verification-020)
+include initial Yandex spam placement and the ordinary form shown on repeated
+confirmation. These results support the unchanged 1.0.0 runtime; they
+are not a live-site test of an installed 1.0.0 package.
+The installed 1.0.0 candidate passed 314 server tests on each of two framework
+pairs with SQLite and PostgreSQL 16, 33 JavaScript tests, package checks and
+independent upgrade/restoration rehearsals. Historical-browser checks covered
+Chrome 142 and Firefox 140 ESR with and without JavaScript; Windows checks used
+ARM64, with Chrome x64 under emulation. Native Windows x64 was not tested.
+
+Support, compatibility promises and verification limits are defined by
+[Stability](../wiki/Stability.md). No exhaustive browser/device/WCAG certification,
+native-language review or universal server-capacity guarantee is claimed.

{commentail-0.2.0 → commentail-1.0.0}/docs/wiki/Changelog.md

@@ -3,6 +3,16 @@
 Each release records changes relative to the previous version. Upgrade notes
 describe changes that an existing installation needs to review.
 
+## [1.0.0] — 2026-10-19 · Stable
+
+The feature set is frozen at 0.2.0 Beta. This release introduces the documented
+stable API and compatibility policy; runtime, dependencies and migration files
+are unchanged from 0.2.0. Live-site verification of published 0.2.0 is recorded
+in the [verification guide](Example-and-testing.md#reported-live-site-verification-020).
+The documented integration surface now follows semantic versioning and the
+stated deprecation policy. Direct upgrade and backup-restoration rehearsals
+cover 0.1.0 and 0.2.0 on SQLite and PostgreSQL 16.
+
 ## [0.2.0] — 2026-10-19 · Beta
 
 Changes from **0.1.1 → 0.2.0**.
@@ -113,4 +123,5 @@ See [0.1.0 release notes](Release-0.1.0.md).
 [0.1.1]: https://github.com/hardcodd/Commentail/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/hardcodd/Commentail/releases/tag/v0.1.0
 
+[1.0.0]: https://github.com/hardcodd/Commentail/compare/v0.2.0...v1.0.0
 [0.2.0]: https://github.com/hardcodd/Commentail/compare/v0.1.1...v0.2.0

{commentail-0.2.0 → commentail-1.0.0}/docs/wiki/Example-and-testing.md

@@ -67,6 +67,39 @@ The minimum supported Wagtail patch is 7.4.3. Earlier 7.4 patches are excluded
 because of upstream security fixes; the test pin and installed environments use
 7.4.3. See the [Wagtail 7.4.3 release notes](https://docs.wagtail.org/en/stable/releases/7.4.3.html).
 
+## Reported live-site verification: 0.2.0
+
+On 19 October 2026, the integrating site's owner supplied a verification report
+for published 0.2.0 on Django 6.1.2/Wagtail 8.0, using private Firefox sessions
+and real Gmail/Yandex inboxes. It covered guest submission with CAPTCHA, email
+confirmation, moderation, edits retaining the previous public text until approval,
+reply notifications received after approval, and unsubscribe. Approved replies
+after unsubscribe created no mail jobs; repeated unsubscribe kept delivery disabled.
+Expired edit links were rejected, including while the comments were public.
+
+All 24 reported negative cases were rejected without changes to the checked
+related records: six altered-token GETs, six altered-token POSTs with valid CSRF
+(404), and twelve POSTs without or with incorrect CSRF (403). Record counts and
+SHA-256 digests of full serialized related records matched before and after.
+This is bounded verification, not a complete security audit.
+
+The report also covered a PyPI 0.1.0 → 0.2.0 upgrade, migration/data preservation,
+independent backup restoration, host email overrides, static assets, RU/EN routes
+and the scheduled worker. Host tests passed 346/350 initially; four analytics
+configuration errors were followed by 30 passing affected tests with the usual
+test setting. A full corrected 350-test rerun was not reported.
+
+Two observations remain: Yandex initially classified confirmation mail as spam;
+later checked messages reached the inbox after marking it as not spam. The owner
+reports that Yandex advised recipients to mark legitimate mail as not spam to help
+build sender reputation over time. This delivery observation is not treated as a
+code defect or release blocker; future inbox placement is not guaranteed. Repeated
+email confirmation showed the ordinary confirmation form, without a distinct
+already-confirmed message, while preserving confirmation/subscription state.
+Neither sustained deliverability nor all browser/email-client combinations were
+established. These are owner-reported 0.2.0 results; they support the unchanged
+runtime of 1.0.0 and are not a live-site test of an installed 1.0.0 package.
+
 ## Acceptance boundaries
 
 [Performance](Performance.md) describes query regressions, the synthetic load
@@ -79,10 +112,14 @@ separate from hosted CI status; inspect the workflow run for the revision in use
 See [GitHub Actions](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml).
 Installed Safari, Chrome, Yandex and Firefox were exercised with/without JS, including
 CSV, guest mail and inline interactions. Selected Safari VoiceOver scenarios and a
-physical phone were checked. Previous major browser versions remain unverified;
-this is not exhaustive device coverage or accessibility certification. Host-specific
+physical phone were checked. Historical checks also covered Chrome 142 on macOS
+and Windows ARM64 and Firefox 140 ESR on Windows ARM64, with and without JavaScript.
+They exercised responsive layouts, pagination, replies, editing, validation and
+network-error draft retention. Windows Chrome x64 ran under emulation; native
+Windows x64 was not checked. Older Firefox on macOS could not complete startup
+for automation. This is not exhaustive device coverage or accessibility certification. Host-specific
 customizations and deployment policies need their own acceptance checks.
 
 ---
 
-[← Troubleshooting](Troubleshooting.md) · [Documentation home](Home.md) · [Release 0.2.0 →](Release-0.2.0.md)
+[← Troubleshooting](Troubleshooting.md) · [Documentation home](Home.md) · [Release 1.0.0 →](Release-1.0.0.md)

{commentail-0.2.0 → commentail-1.0.0}/docs/wiki/Home.md

@@ -3,7 +3,7 @@
 **Self-hosted comments for Wagtail CMS.** Add moderated discussions to Wagtail
 Pages and registered Django models using your site's accounts, templates and styles.
 
-> **0.2.0 Beta:** Wagtail 7.4.3+ / Django 5.2 or 6.0; Wagtail 8.0 / Django 5.2, 6.0 or 6.1; Python 3.12–3.14; file SQLite and PostgreSQL 16.
+> **1.0.0 Stable:** Wagtail 7.4.3+ / Django 5.2 or 6.0; Wagtail 8.0 / Django 5.2, 6.0 or 6.1; Python 3.12–3.14; file SQLite and PostgreSQL 16.
 > Published 0.1.0 retains Wagtail >=7.4.3,<7.5 and Django 5.2 support.
 
 ## Find your guide
@@ -28,7 +28,8 @@ Pages and registered Django models using your site's accounts, templates and sty
 | Understand query costs and run load checks | [Performance](Performance.md) |
 | Diagnose a problem | [Troubleshooting](Troubleshooting.md) |
 | Run the example and tests | [Example and testing](Example-and-testing.md) |
-| Read the current release scope | [Release 0.2.0](Release-0.2.0.md) |
+| Read the current release scope | [Release 1.0.0](Release-1.0.0.md) |
+| Understand the stable contract | [Stability](Stability.md) |
 | Compare versions | [Changelog](Changelog.md) |
 | See planned work | [Roadmap](Roadmap.md) |
 | Read the initial release scope | [Release 0.1.0](Release-0.1.0.md) |

{commentail-0.2.0 → commentail-1.0.0}/docs/wiki/Installation.md

@@ -2,7 +2,7 @@
 
 ## Requirements and package
 
-| Component | 0.2.0 Beta |
+| Component | 1.0.0 Stable |
 | --- | --- |
 | Python | 3.12, 3.13, 3.14 |
 | Wagtail / Django | 7.4.3+ in 7.4 / Django 5.2 or 6.0; 8.0.x / Django 5.2, 6.0 or 6.1 |
@@ -18,16 +18,16 @@ verification. The published 0.1.0 artifact retains its original bounds:
 In a virtual environment, install the release from PyPI:
 
 ```sh
-python -m pip install commentail==0.2.0
+python -m pip install commentail==1.0.0
 ```
 
 For the PostgreSQL driver use
-`python -m pip install 'commentail[postgres]==0.2.0'`.
+`python -m pip install 'commentail[postgres]==1.0.0'`.
 Alternatively, install a downloaded wheel or extract the source archive and run
 `python -m pip install .` in its root. Your site's `DATABASES` setting still selects
 the actual database.
 For downloaded release archives, verify the supplied checksum before installation.
-See [0.2.0 changes and upgrade notes](Release-0.2.0.md) and the
+See [1.0.0 changes and upgrade notes](Release-1.0.0.md) and the
 [version-to-version changelog](Changelog.md).
 
 ## 1. Apps, middleware and templates
@@ -95,6 +95,10 @@ message before opening the integration to visitors.
 
 ## Upgrading and restoring
 
+Version 1.0.0 changes no runtime files, dependencies or migrations from 0.2.0.
+Run the normal checks and static collection after installing; the migration notes
+below apply when upgrading from earlier versions.
+
 Version 0.2.0 adds migration `0014_reading_indexes` over 0.1.1. It creates
 publication/thread, active CAPTCHA and rate-cleanup indexes without changing
 comment content or state. Standard index builds may block writes and need extra