BUNNY BOT 1.0.3 — CLEAN DEVELOPMENT SOURCE
===========================================

This package contains source code and runtime assets only. It intentionally does
not include build output, release archives, personal configuration, accounts,
licenses, logs, screenshots, databases, backups, or private signing material.

Development
-----------
1. Extract this folder under 02_DEVELOPMENT.
2. Run run.bat. The first run may install packages from requirements.txt.
3. Use run_dry.bat for a no-tap/no-swipe safety session.
4. Keep the untouched rescue copy under 01_MASTER_SOURCE_CLEAN.

Build files are maintained separately under 09_BUILD_TOOLS and should be copied
only into a temporary 03_BUILD_STAGING folder when creating a release.

The signed update manifest defaults to:
https://updates.hasanmdaraty.cc/BUNNY-BOT/manifest.json

The Ed25519 private signing key must never be placed in this source folder.

Where the built program may be installed
----------------------------------------
BUNNY BOT keeps everything it owns beside its own executable: config.json,
stats.json, data/bunnybot.db, data/license.dat, logs/ and instance.lock. That
makes a release folder self-contained and portable, and it is what allows a
second emulator to be driven simply by copying the folder.

The consequence is that the folder must be writable by the person running it:

  * Install under Documents, the Desktop, or a data drive.
  * Do NOT install under Program Files or any other location that needs
    administrator rights. Startup detects this and refuses with an explanation
    rather than failing later with a half-written database.
  * One folder per emulator. Two windows may not share one folder; the claim on
    each emulator is recorded under %LOCALAPPDATA%\BUNNY BOT\locks so copies
    installed anywhere on the PC can still see each other.
  * Prefer a folder that is not continuously uploaded by a sync client. The
    SQLite database is opened in WAL mode and is written while the bot runs, so
    a client that copies the file mid-write competes with the program for it.
