diff options
| author | Your Name <you@example.com> | 2026-05-20 02:23:30 +0530 |
|---|---|---|
| committer | Your Name <you@example.com> | 2026-05-20 02:23:30 +0530 |
| commit | 32e1bfd27b849652a7c9d48ad75e13c44bdf8247 (patch) | |
| tree | 7ad77a5c310a6c824771ffa6df5cc5420a603c91 /CONSOLIDATION.md | |
| parent | 15c8e9f5f32422631e6519e54cd463d933ec5e84 (diff) | |
docs: update CONSOLIDATION.md — phases 1-3 and 6 complete
Diffstat (limited to 'CONSOLIDATION.md')
| -rw-r--r-- | CONSOLIDATION.md | 70 |
1 files changed, 31 insertions, 39 deletions
diff --git a/CONSOLIDATION.md b/CONSOLIDATION.md index 5180987..3e96dbf 100644 --- a/CONSOLIDATION.md +++ b/CONSOLIDATION.md | |||
| @@ -21,41 +21,33 @@ esp-miner (master) | |||
| 21 | 21 | ||
| 22 | ## Phase 1: Preserve Uncommitted Work | 22 | ## Phase 1: Preserve Uncommitted Work |
| 23 | 23 | ||
| 24 | - [ ] **1.1** Apply stash@{1} to master (AP-only services, market config wiring, sta_connecting guard) | 24 | - [x] **1.1** Revert broken merge (be4788b) that gutted config.c/tollgate_main.c/tollgate_api.c |
| 25 | - [ ] **1.2** Commit: "feat: AP-only services startup + market config wiring (from stash)" | 25 | - [x] **1.2** Restore tollgate_core component + tollgate_platform.c + docs from merge |
| 26 | - [ ] **1.3** Drop stashes 0, 2, 3 (compiled binaries only, no source) | 26 | - [x] **1.3** Wire market config fields in config.c |
| 27 | - [ ] **1.4** Verify master builds: `idf.py build` | 27 | - [x] **1.4** Drop all 4 stashes (binaries only, content already in master) |
| 28 | - [ ] **1.5** Verify unit tests pass: `make test-unit` | 28 | - [x] **1.5** Verify master builds: `idf.py build` — PASS |
| 29 | - [ ] **1.6** Commit + push | 29 | - [x] **1.6** Verify unit tests pass: `make test-unit` — 16/16 PASS |
| 30 | - [x] **1.7** Commit + push | ||
| 30 | 31 | ||
| 31 | ## Phase 2: Merge feature/display-fix (touch + WiFi setup UI) | 32 | ## Phase 2: Merge feature/display-fix (touch + WiFi setup UI) |
| 32 | 33 | ||
| 33 | - [ ] **2.1** Verify feature/display-fix has no uncommitted source changes (only binaries — confirmed) | 34 | - [x] **2.1** Verify feature/display-fix has no uncommitted source changes (only binaries — confirmed) |
| 34 | - [ ] **2.2** Squash-merge feature/display-fix into master | 35 | - [x] **2.2** Squash-merge feature/display-fix into master |
| 35 | - [ ] **2.3** Resolve any conflicts (display.c/font.c may conflict with master versions) | 36 | - [x] **2.3** Resolve conflicts: took master for config/cvm/api/main, display-fix for display/axs15231b |
| 36 | - [ ] **2.4** Verify build: `idf.py build` | 37 | - [x] **2.4** Fix display_update() call signature (7 args), add tollgate_config_add_wifi() |
| 37 | - [ ] **2.5** Verify unit tests: `make test-unit` (should pick up test_touch, test_keyboard, test_wifi_setup) | 38 | - [x] **2.5** Verify build: `idf.py build` — PASS |
| 38 | - [ ] **2.6** Commit + push | 39 | - [x] **2.6** Verify unit tests: `make test-unit` — 16/16 PASS |
| 40 | - [x] **2.7** Commit + push | ||
| 39 | 41 | ||
| 40 | ## Phase 3: Merge feature/miner-integration (full tollgate_core) | 42 | ## Phase 3: Merge feature/miner-integration (full tollgate_core) |
| 41 | 43 | ||
| 42 | This is the critical merge. Master has the OLD tollgate_core skeleton (9 files, 7 callbacks). | 44 | - [x] **3.1** Verify feature/miner-integration has no uncommitted source changes (only binaries — confirmed) |
| 43 | feature/miner-integration has the FULL version (13 files, 22 callbacks, extern C, mining + stratum). | 45 | - [x] **3.2** Replace tollgate_core with full version (13 files, 22 callbacks, mining + stratum + extern C) |
| 44 | We need to take the miner-integration version of tollgate_core entirely. | 46 | - [x] **3.3** Commit: "feat: upgrade tollgate_core to full version with mining + stratum" |
| 45 | 47 | - [x] **3.4** Copy MINER_INTEGRATION_PLAN.md from feature branch | |
| 46 | - [ ] **3.1** Verify feature/miner-integration has no uncommitted source changes (only binaries — confirmed) | 48 | - [x] **3.5** Verify build: `idf.py build` — PASS |
| 47 | - [ ] **3.2** Checkout feature/miner-integration version of tollgate_core into master: | 49 | - [x] **3.6** Verify unit tests: `make test-unit` — 16/16 PASS |
| 48 | - Replace `components/tollgate_core/` entirely with the miner-integration version | 50 | - [x] **3.7** Commit + push |
| 49 | - This adds: tollgate_core_mining.c/h, tollgate_core_stratum_proxy.c/h | ||
| 50 | - This updates: tollgate_core.h (extern C + 5 new mining API functions) | ||
| 51 | - This updates: tollgate_platform.h (extern C + 14 new platform callbacks for mining/stratum) | ||
| 52 | - This updates: tollgate_core_firewall.c (conditional NAPT) | ||
| 53 | - This updates: CMakeLists.txt (mining + stratum source files) | ||
| 54 | - [ ] **3.3** Commit: "feat: upgrade tollgate_core to full version with mining + stratum + extern C" | ||
| 55 | - [ ] **3.4** Merge remaining docs from feature/miner-integration (REMOTES.md, MINER_INTEGRATION_PLAN.md) | ||
| 56 | - [ ] **3.5** Verify build: `idf.py build` | ||
| 57 | - [ ] **3.6** Verify unit tests: `make test-unit` | ||
| 58 | - [ ] **3.7** Commit + push | ||
| 59 | 51 | ||
| 60 | ## Phase 4: Restructure — Option B (main/ calls tollgate_core API) | 52 | ## Phase 4: Restructure — Option B (main/ calls tollgate_core API) |
| 61 | 53 | ||
| @@ -93,16 +85,16 @@ Move module logic from main/ into components/tollgate_core/, making main/ a thin | |||
| 93 | 85 | ||
| 94 | ## Phase 6: Delete Branches & Worktrees | 86 | ## Phase 6: Delete Branches & Worktrees |
| 95 | 87 | ||
| 96 | - [ ] **6.1** Delete feature/tollgate-core-component branch (merged in commit be4788b) | 88 | - [x] **6.1** Delete feature/tollgate-core-component branch (merged via Phase 1) |
| 97 | - [ ] **6.2** Delete backup/multi-mint-support-pre-rebase branch (fully in master) | 89 | - [x] **6.2** Delete backup/multi-mint-support-pre-rebase branch (fully in master) |
| 98 | - [ ] **6.3** Delete feature/display-fix branch (merged in Phase 2) | 90 | - [x] **6.3** Delete feature/display-fix branch (merged in Phase 2) |
| 99 | - [ ] **6.4** Delete feature/miner-integration branch (merged in Phase 3) | 91 | - [x] **6.4** Delete feature/miner-integration branch (merged in Phase 3) |
| 100 | - [ ] **6.5** Remove worktree: esp32-miner-integration/ | 92 | - [x] **6.5** Remove worktree: esp32-miner-integration/ |
| 101 | - [ ] **6.6** Remove worktree: esp32-tollgate-arch/ | 93 | - [x] **6.6** Remove worktree: esp32-tollgate-arch/ |
| 102 | - [ ] **6.7** Remove worktree: esp32-tollgate-display/ | 94 | - [x] **6.7** Remove worktree: esp32-tollgate-display/ |
| 103 | - [ ] **6.8** Clean up test binaries from git tracking: `git rm --cached tests/unit/test_*` (keep in .gitignore) | 95 | - [x] **6.8** Clean up test binaries from git tracking: `git rm --cached` |
| 104 | - [ ] **6.9** Refresh backup bundles | 96 | - [x] **6.9** Refresh backup bundles |
| 105 | - [ ] **6.10** Push everything | 97 | - [x] **6.10** Push to orangesync + origin |
| 106 | 98 | ||
| 107 | ## Phase 7: Update esp-miner (optional, after consolidation) | 99 | ## Phase 7: Update esp-miner (optional, after consolidation) |
| 108 | 100 | ||