Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 21 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Windows x64 Beta 1 · MSI 1.8.0.1
Windows x64 Beta 1 · MSI 1.8.1.1

The signed [Windows x64 beta 1.8.0.1](https://github.com/townlight/townlight/releases/tag/townlight-windows-v1.8.0.1) adds the three staff workspaces and automatically refreshes the bundled runtime when upgrading from 1.7.2.1.
Windows 1.8.1.1 adds shared meeting imports for 31 source families, with 34 supported source/format pairs. Installed Windows Sandbox checks exercised preview, save and durable readback using public captures and fixtures, plus the documented Townlight handoffs. These checks do not establish automatic discovery on every live portal or a complete retest of every module.

- <a href="https://townlight.github.io/manuals/core.html#townlight-core-manual" id="toc-townlight-core-manual">Townlight Core Manual</a>
- <a href="https://townlight.github.io/manuals/core.html#contents" id="toc-contents">Contents</a>
Expand All @@ -26,6 +26,17 @@ The signed [Windows x64 beta 1.8.0.1](https://github.com/townlight/townlight/rel

# Townlight Core Manual

## Shared meeting imports · Windows 1.8.1.1

Windows 1.8.1.1 adds shared meeting imports for 31 source families, with 34 supported source/format pairs. Installed Windows Sandbox checks exercised preview, save and durable readback using public captures and fixtures, plus the documented Townlight handoffs. These checks do not establish automatic discovery on every live portal or a complete retest of every module.

[All 31 sources, formats and handoffs](https://townlight.github.io/manuals/meeting-imports.html) · [Installed acceptance](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.1.1/ACCEPTANCE-Windows-1.8.1.1.md).

Windows 1.8.1.1 has fresh-install acceptance. An in-place upgrade to 1.8.1.1 was not exercised. The previous Windows 1.8.0.1 release tested upgrade from 1.7.2.1; that result applies to 1.8.0.1. Before an existing-city evaluation, back up city data and settings, close Townlight, keep the existing %LOCALAPPDATA%\CivicSuite profile, and use the same Windows account. Keep the prior installer and a restore path. Station continues to use its separately configured service.

The accepted MSI contains Townlight Runtime 0.3.1 and Meetings 1.0.6 distributions. Its health version strings still report Runtime 0.3.0 and Meetings 1.0.5. Default-branch source corrects those display strings; the signed MSI and its exact build source remain unchanged.


**Townlight Beta 1** · Naming candidate documentation edition 2 November 2026

## Contents
Expand Down Expand Up @@ -61,26 +72,26 @@ Staff should begin with First run and Daily workflow. Administrators should also
| Identity | Value |
|----|----|
| Documentation | Townlight Beta 1 naming, Access and Notice candidate |
| Windows MSI version | 1.8.0.1 |
| Windows MSI version | 1.8.1.1 |
| Product component | townlight-core 1.3.0.dev2 |
| Principal import package | townlight_core |
| Native desktop source version | 1.8.0-1 |
| Candidate hashes | [SHA-256 checksums](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/SHA256SUMS-Windows-1.8.0.1.txt) and [Windows acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) |
| Native desktop source version | 1.8.1-1 |
| Candidate hashes | [SHA-256 checksums](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.1.1/SHA256SUMS-Windows-1.8.1.1.txt) and [Windows acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.1.1/ACCEPTANCE-Windows-1.8.1.1.md) |
| Current owned software license | AGPL-3.0-only |
| Acceptance composition | Windows x64 fresh install and upgrade from 1.7.2.1. Select the full profile. Station uses separate configuration. |

Start a new installation with an empty database and fresh Windows profile. For an upgrade from Windows 1.7.2.1, keep the existing profile. The approved profile path is `%LOCALAPPDATA%\CivicSuite`. Keep existing profiles and backups.

## First run

**Upgrade from 1.7.2.1.** For the tested upgrade from 1.7.2.1, back up city data and settings, close Townlight, run the signed Windows 1.8.0.1 MSI, and reopen Townlight under the same Windows account with its existing profile. Keep the existing `%LOCALAPPDATA%\CivicSuite` directory. Upgrade paths from versions older than 1.7.2.1 are unverified. Station uses its separately configured service.
Windows 1.8.1.1 has fresh-install acceptance. An in-place upgrade to 1.8.1.1 was not exercised. The previous Windows 1.8.0.1 release tested upgrade from 1.7.2.1; that result applies to 1.8.0.1. Before an existing-city evaluation, back up city data and settings, close Townlight, keep the existing %LOCALAPPDATA%\CivicSuite profile, and use the same Windows account. Keep the prior installer and a restore path. Station continues to use its separately configured service.

### Fresh installation

Run the signed Windows 1.8.0.1 MSI and use an empty database and a new Townlight profile for first run.
Run the signed Windows 1.8.1.1 MSI and use an empty database and a new Townlight profile for first run.

1. Download the signed MSI, matching source companion and checksums from the [public Windows release](https://github.com/townlight/townlight/releases/tag/townlight-windows-v1.8.0.1).
2. Verify the MSI hash and Authenticode publisher before installation. See the [Windows acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) for the tested setup.
1. Download the signed MSI, matching source companion and checksums from the [public Windows release](https://github.com/townlight/townlight/releases/tag/townlight-windows-v1.8.1.1).
2. Verify the MSI hash and Authenticode publisher before installation. See the [Windows acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.1.1/ACCEPTANCE-Windows-1.8.1.1.md) for the tested setup.
3. Launch Townlight under the intended named Windows account. Choose the storage folders. Select **Townlight Inspections candidate** (`inspections-preview`) for the bounded desktop composition, including Access and Notice. A narrower default selection will not expose all workspaces.
4. Enter the city profile, time zone and contacts. Create the first named local administrator, sign in and choose protected backup storage. **Continue without local AI** is valid for the deterministic workflows.
5. Run Health Check and wait for readiness. Open Townlight. In System Health select **Finish Records Migration** to activate the canonical Python/PostgreSQL runtime. Do not fabricate migration receipts or seed accounts.
Expand Down Expand Up @@ -371,7 +382,7 @@ On failure, record the time, selected composition, component/installer versions

## Verified workflows and limits

The table records selected synthetic workflows from the original [Windows 1.6.0.1 Beta 1](https://github.com/townlight/townlight/releases/tag/townlight-beta-1) Sandbox run. Station’s later delivery has [separate Windows 1.6.0.1 acceptance](https://github.com/townlight/townlight/releases/tag/townlight-beta-1-station-delivery). See the [Windows 1.8.0.1 acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) for the workflows and upgrade path exercised on the current MSI.
The table records selected synthetic workflows from the original [Windows 1.6.0.1 Beta 1](https://github.com/townlight/townlight/releases/tag/townlight-beta-1) Sandbox run. Station’s later delivery has [separate Windows 1.6.0.1 acceptance](https://github.com/townlight/townlight/releases/tag/townlight-beta-1-station-delivery). See the [Windows 1.8.0.1 acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) for the workflows and upgrade path exercised on the previous 1.8.0.1 MSI.

| Product | Recorded result | Precisely exercised |
|----|----|----|
Expand Down
25 changes: 18 additions & 7 deletions README.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,17 @@
Windows x64 Beta 1 · MSI 1.8.0.1

The signed Windows x64 beta 1.8.0.1 adds the three staff workspaces and
## Shared meeting imports · Windows 1.8.1.1

Windows 1.8.1.1 adds shared meeting imports for 31 source families, with 34 supported source/format pairs. Installed Windows Sandbox checks exercised preview, save and durable readback using public captures and fixtures, plus the documented Townlight handoffs. These checks do not establish automatic discovery on every live portal or a complete retest of every module.

[All 31 sources, formats and handoffs](https://townlight.github.io/manuals/meeting-imports.html) · [Installed acceptance](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.1.1/ACCEPTANCE-Windows-1.8.1.1.md).

Windows 1.8.1.1 has fresh-install acceptance. An in-place upgrade to 1.8.1.1 was not exercised. The previous Windows 1.8.0.1 release tested upgrade from 1.7.2.1; that result applies to 1.8.0.1. Before an existing-city evaluation, back up city data and settings, close Townlight, keep the existing %LOCALAPPDATA%\CivicSuite profile, and use the same Windows account. Keep the prior installer and a restore path. Station continues to use its separately configured service.

The accepted MSI contains Townlight Runtime 0.3.1 and Meetings 1.0.6 distributions. Its health version strings still report Runtime 0.3.0 and Meetings 1.0.5. Default-branch source corrects those display strings; the signed MSI and its exact build source remain unchanged.

Windows x64 Beta 1 · MSI 1.8.1.1

The signed Windows x64 beta 1.8.1.1 adds the three staff workspaces and
automatically refreshes the bundled runtime when upgrading from 1.7.2.1.

- Townlight Core Manual
Expand Down Expand Up @@ -73,10 +84,10 @@ Beta identity
Identity Value
-------------------------------- -------------------------------------------------------------------------------------------------------------------
Documentation Townlight Beta 1 naming, Access and Notice candidate
Windows MSI version 1.8.0.1
Windows MSI version 1.8.1.1
Product component townlight-core 1.3.0.dev2
Principal import package townlight_core
Native desktop source version 1.8.0-1
Native desktop source version 1.8.1-1
Candidate hashes SHA-256 checksums and Windows acceptance summary
Current owned software license AGPL-3.0-only
Acceptance composition Windows x64 fresh install and upgrade from 1.7.2.1. Select the full profile. Station uses separate configuration.
Expand All @@ -89,15 +100,15 @@ profiles and backups.
First run

Upgrade from 1.7.2.1. For the tested upgrade from 1.7.2.1, back up city
data and settings, close Townlight, run the signed Windows 1.8.0.1 MSI,
data and settings, close Townlight, run the signed Windows 1.8.1.1 MSI,
and reopen Townlight under the same Windows account with its existing
profile. Keep the existing %LOCALAPPDATA%\CivicSuite directory. Upgrade
paths from versions older than 1.7.2.1 are unverified. Station uses its
separately configured service.

Fresh installation

Run the signed Windows 1.8.0.1 MSI and use an empty database and a new
Run the signed Windows 1.8.1.1 MSI and use an empty database and a new
Townlight profile for first run.

1. Download the signed MSI, matching source companion and checksums
Expand Down Expand Up @@ -595,7 +606,7 @@ Verified workflows and limits
The table records selected synthetic workflows from the original Windows
1.6.0.1 Beta 1 Sandbox run. Station’s later delivery has separate
Windows 1.6.0.1 acceptance. See the Windows 1.8.0.1 acceptance summary
for the workflows and upgrade path exercised on the current MSI.
for the workflows and upgrade path exercised on the previous 1.8.0.1 MSI.

Product Recorded result Precisely exercised
--------- ----------------- --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Expand Down
11 changes: 11 additions & 0 deletions SUPPORT.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,16 @@
# Support

## Shared meeting imports · Windows 1.8.1.1

Windows 1.8.1.1 adds shared meeting imports for 31 source families, with 34 supported source/format pairs. Installed Windows Sandbox checks exercised preview, save and durable readback using public captures and fixtures, plus the documented Townlight handoffs. These checks do not establish automatic discovery on every live portal or a complete retest of every module.

[All 31 sources, formats and handoffs](https://townlight.github.io/manuals/meeting-imports.html) · [Installed acceptance](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.1.1/ACCEPTANCE-Windows-1.8.1.1.md).

Windows 1.8.1.1 has fresh-install acceptance. An in-place upgrade to 1.8.1.1 was not exercised. The previous Windows 1.8.0.1 release tested upgrade from 1.7.2.1; that result applies to 1.8.0.1. Before an existing-city evaluation, back up city data and settings, close Townlight, keep the existing %LOCALAPPDATA%\CivicSuite profile, and use the same Windows account. Keep the prior installer and a restore path. Station continues to use its separately configured service.

The accepted MSI contains Townlight Runtime 0.3.1 and Meetings 1.0.6 distributions. Its health version strings still report Runtime 0.3.0 and Meetings 1.0.5. Default-branch source corrects those display strings; the signed MSI and its exact build source remain unchanged.


townlight_core is a shared platform library for the Townlight product family. Support is community-driven via GitHub.

## Where to ask
Expand Down
Binary file modified USER-MANUAL.docx
Binary file not shown.
Loading
Loading