ANGLO ASCOT OFFICE TRACKER
Public beta 2.1.0-beta.3 | Update, uninstall and recovery

UPDATE AN EXISTING TRACKER
1. Export a full backup from Settings & backups and keep it safe.
2. Close the tracker browser tab and any reminder pop-up.
3. Download the new ZIP and choose Extract All into a fresh folder.
4. Double-click update.cmd under the SAME Windows login used previously.
5. Wait for successful setup. Open the existing Office Tracker shortcut.
6. If an older interface is cached, press Ctrl+F5. Run Test Reminder once.

Uninstall is not required before an update. setup.cmd and update.cmd replace
the same installed app at:
  %LOCALAPPDATA%\AAG-Office-Tracker\app
Saved records live outside that app folder. Updates preserve company details,
dates, document checks, notes, period history and reminder history.
The public release starts empty for new users and adds no bundled companies
when used as an update. Existing locally saved companies remain available.

The app package identity and data folder remain compatible with prior Office
Tracker releases. Shortcuts retain their existing Office Tracker names.
Windows Settings > Apps identifies this release as Anglo Ascot Office Tracker.
Use the same Windows account for updates. An administrator account is normally
unnecessary. There is no automatic update download or background update check.

Setup validates and reuses the installed portable runtime when possible. If
it is missing or unsuitable, setup needs HTTPS access to nodejs.org to obtain
a replacement. Downloads and settings-write checks run before stopping the
installed app. The updater checks ownership before stopping tracker tasks,
processes and shortcuts. It does not stop unrelated Node or PowerShell apps.

A dated record snapshot is saved in upgrade-backups before app activation.
The previous app is kept in app.previous; that copy is replaced on the next
successful update. Older record snapshots remain in upgrade-backups.

UNINSTALL
Use one of these controls under the same Windows login:
  - Office Tracker - Uninstall on the desktop.
  - Settings > Apps > Anglo Ascot Office Tracker > Uninstall.
  - uninstall.cmd in the extracted package.

Uninstall stops tracker processes and reminders, removes its task or Startup
watcher, shortcuts, installed app/runtime, app.previous and matching per-user
Apps entry. It makes a dated snapshot and PRESERVES records and backups in:
  %LOCALAPPDATA%\AAG-Office-Tracker
Close the browser tab afterwards. The extracted ZIP folder is separate and
can be removed manually without deleting saved records.

REINSTALL AND RESTORE
Run setup.cmd under the same Windows login to reuse preserved records.
Reinstallation may need internet because uninstall removes the runtime.
To restore a backup, use Restore a backup in Settings & backups and choose
the snapshot's data.json. Restoration replaces current records after
validation and a separate safety backup. Read the confirmation carefully.

If you intend to permanently erase saved records as well, export any wanted
backup first, uninstall, then remove the preserved data folder and any separate
backup copies yourself. Deleting those files is permanent.

UPDATE FAILURE
If activation fails, setup attempts to restore the previous app and record
snapshot. Reminders remain disabled until setup succeeds. Read the onscreen
error and setup.log before retrying. A failed setup is not a completed update.
If manual recovery is needed, preserve the snapshot in:
  %LOCALAPPDATA%\AAG-Office-Tracker\upgrade-backups\before-upgrade-...
Restore its data.json through the app after a successful reinstall, or get
IT help with the app stopped. Do not run an old app against newer migrated
records without first restoring a matching backup.

The installer checks creation and replacement of a disposable settings file
before modifying the installed app. Existing-file replacement uses a real
backup path, avoiding the null-path failure in the prior updater.

DISABLE REMINDERS ONLY
Run remove-reminders.cmd. Records and the installed tracker stay available.
Run setup.cmd again to enable reminders.

Native Windows install, uninstall, task execution and visual rendering need
verification on the target PC. The public release is labelled beta while
that broader platform verification remains outstanding.

Help and feedback: contact@angloascotgroup.com
Website: https://angloascotgroup.com
