docs: remove public run/build instructions and mark deprecated branches

- README: stripped main.py run and Buildozer APK sections; added pre-release execution disclaimer
- OFFICIAL_PROJECT_DOCS: removed run/build lines
- WALLET_SWITCHING_TRANSACTION_HISTORY_FIXES: replaced direct run command with high-level flow
- Added DEPRECATED_BRANCHES.md documenting legacy branches (CalorieAppV11-2, CalorieAppV11-3, chore/repo-hardening)

All direct invocation examples removed per pre-release policy.

Author: CalorieApp Maintainer

README.md

@@ -141,43 +141,11 @@ Robust connectivity with automatic failover:
 ### XRPL Response Caching
 Lightweight in-memory caching for select XRPL requests (e.g. `ServerInfo`) reduces redundant network calls and stabilizes performance under intermittent connectivity. Cache entries automatically expire after a short TTL.
 
-## 🚀 Getting Started
+## 🚀 Getting Started (Public-Safe)
 
-👉 **See the [Quick Start Guide](docs/QUICK_START.md) for detailed setup instructions.**
+> Execution and build instructions are intentionally withheld until a stable, review-approved release milestone. The repository at this stage is for transparency of progress, documentation, and ongoing refactor history — not for end-user execution or distribution.
 
-### Prerequisites
-- Python 3.12+
-- pip package manager
-
-### Installation
-
-1. **Clone the repository:**
-   ```bash
-   git clone https://github.com/CalorieToken/CalorieAppTestnet.git
-   cd CalorieAppTestnet
-   ```
-
-2. **Install dependencies:**
-   ```bash
-   pip install -r requirements.txt
-   ```
-
-3. **Run the application:**
-   ```bash
-   python main.py
-   ```
-
-### Building APK (Android)
-
-1. **Install Buildozer:**
-   ```bash
-   pip install buildozer
-   ```
-
-2. **Build APK:**
-   ```bash
-   buildozer android debug
-   ```
+If you are an authorized collaborator and require internal run/build procedures, request access privately (info@calorietoken.net). All prior direct run examples (e.g. `python main.py`, `buildozer android debug`) have been removed to prevent premature usage of unfinished systems.
 
 ## 📱 Usage
 
@@ -259,11 +227,8 @@ Production builds simply omit these variables and the app reverts to automatic b
 
 Breakpoints remain unchanged ensuring cross-platform compatibility; overrides are strictly opt-in for development convenience.
 
-### Debug Overlay
-Enable visual debugging of the responsive system with:
-```powershell
-$env:DEBUG_RESPONSIVE="1"; python main.py
-```
+### Debug Overlay (Development Only)
+Activation mechanics exist but invocation commands are withheld pre-release. Overlay shows breakpoint class, scaling factors, and dimensions when enabled internally.
 
 This displays a small badge in the top-right corner showing:
 - Current size class (xs/sm/md/lg/xl)
@@ -296,13 +261,7 @@ See also:
 - Material Design 3: https://m3.material.io/
 
 ### Manual Testing
-The app has been extensively tested with:
-- ✅ Navigation flow testing across all screens
-- ✅ XRPL connectivity and failover scenarios
-- ✅ Wallet creation and import processes
-- ✅ Transaction sending and receiving
-- ✅ Performance optimization validation
-- ✅ Offline mode functionality
+Internal test cycles include navigation, XRPL connectivity/failover simulation, wallet creation/import flows, transaction lifecycle validation, performance sampling, and offline mode handling. Detailed invocation steps are withheld until stable release.
 
 ## 🤝 Contributing
 

docs/DEPRECATED_BRANCHES.md

@@ -0,0 +1,22 @@
+# Deprecated Branches
+
+The following branches are now marked as DEPRECATED and should not be used for new work. They are retained temporarily for historical reference and may be deleted after archival.
+
+| Branch | Status | Replacement |
+|--------|--------|-------------|
+| `chore/repo-hardening` | Deprecated (merged) | `main` |
+| `CalorieAppV11-2` | Deprecated (legacy iteration) | `main` |
+| `CalorieAppV11-3` | Deprecated (legacy iteration) | `main` |
+
+Active development branches:
+- `main` (canonical)
+- `feature/visual-refinement-v1.1.2` (current visual + social asset refinements)
+
+Policy:
+- No new commits should land on deprecated branches.
+- Open PRs (if any) should be closed or retargeted to `main`.
+- Automated tooling and CI should ignore deprecated branches.
+
+For questions regarding archival or branch recovery, contact: info@calorietoken.net
+
+Last updated: 2025-11-19

docs/OFFICIAL_PROJECT_DOCS.md

@@ -24,11 +24,9 @@ CalorieApp is a mobile-first wallet and food tracking application integrated wit
 - Food tracking features
 - Automated UX Tour (public-safe overview)
 
-## Getting Started
+## Getting Started (Public-Safe)
 
-- Quick Start: `docs/QUICK_START.md`
-- Run: `python main.py`
-- Android builds: `buildozer android debug`
+Execution and packaging instructions are intentionally withheld while in active Beta. Prior run/build examples removed to discourage use of unfinished components.
 
 ## Key Documents
 

docs/WALLET_SWITCHING_TRANSACTION_HISTORY_FIXES.md

@@ -69,20 +69,11 @@
 
 ## 🎯 **Testing Instructions**
 
-### **Test Wallet Switching**
-1. ✅ Start the application: `python main.py`
-2. ✅ Navigate to the wallet screen
-3. ✅ Click the wallet dropdown menu
-4. ✅ Switch between available wallets (2 and 3)
-5. ✅ Verify no nonce errors appear
-
-### **Test Transaction History**
-1. ✅ Select a funded wallet (like the one from Ripple Altnet faucet)
-2. ✅ Check terminal output for debug messages:
-   - `🔍 Requesting transaction history for: [address]`
-   - `📡 Transaction history response status: SUCCESS`
-   - `✅ Found X transactions!` or `ℹ️ No transactions found`
-3. ✅ Look for transaction details in the app interface
+### **Test Wallet Switching (Procedure Withheld)**
+Runtime invocation commands removed. High-level flow: start app, navigate wallet screen, switch wallets, confirm absence of nonce warnings.
+
+### **Test Transaction History (Procedure Withheld)**
+Select funded wallet, observe debug output (messages listed below), verify UI reflects transaction presence or absence.
 
 ### **Create New Wallet Test**
 1. ✅ Use "Create Extra Wallet" or "Create Wallet" features