feat(lite): lite wallet foundation (inherited working-tree state)

Preserve the previously-uncommitted lite wallet implementation and related dev WIP
under version control:
- src/wallet/ lite services: client bridge, bridge runtime, connection, lifecycle,
  sync, gateway, result parsers, state mapper, artifact contract/resolver, refresh
  services, UI adapters, wallet_backend/capabilities. (Includes two small M1 fixes:
  lifecycle walletReady now parses the response; default chain name -> "main".)
- src/chat/ chat protocol; tests/fixtures/ (lite + hushchat); tools/hushchat_fixture_check.cpp;
  scripts/build-lite-backend-artifact.sh.
- Pre-existing modified app_network/security/wizard, network_refresh_service, sidebar,
  mining_tab, bootstrap dialog, and version headers captured as-is.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

src/wallet/lite_wallet_sync_app_refresh_integration.h

@@ -0,0 +1,172 @@
+#pragma once
+
+#include "lite_sync_service.h"
+#include "lite_wallet_app_refresh_orchestrator.h"
+
+#include <cstddef>
+#include <string>
+#include <vector>
+
+namespace dragonx::wallet {
+
+enum class LiteWalletSyncAppRefreshIntegrationStatus {
+    FutureWorkerQueueFeedReady,
+    WaitingForLifecycle,
+    WaitingForSyncPlan,
+    WaitingForSyncStatus,
+    WaitingForRecovery,
+    WaitingForCancellation,
+    RefreshNotQueued,
+    WorkerQueueUnavailable,
+    UnsafePlan,
+};
+
+enum class LiteWalletSyncAppRefreshIntegrationIssue {
+    LifecycleNotReady,
+    MissingSyncStartPlan,
+    InvalidSyncStartPlan,
+    SyncStartWouldExecute,
+    MissingSyncStatusPlan,
+    InvalidSyncStatusPlan,
+    SyncStatusWouldExecute,
+    MissingRecoveryDecision,
+    SyncStillPolling,
+    SyncRecoveryRequired,
+    SyncRecoveryNeedsUserAttention,
+    CancellationRequired,
+    CancellationUnsupported,
+    RefreshReportRejected,
+    RefreshReportUnsafe,
+    RefreshSkipped,
+    RefreshBlocked,
+    FutureWorkerQueueDisabled,
+    FutureWorkerQueuePressure,
+};
+
+struct LiteWalletSyncAppRefreshLifecycleInput {
+    bool ready = false;
+    WalletBackendStatus status;
+};
+
+struct LiteWalletSyncAppRefreshSyncPlanInput {
+    bool haveStartPlan = false;
+    LiteSyncPlan startPlan;
+    bool haveStatusPlan = false;
+    LiteSyncPlan statusPlan;
+    bool haveRecoveryDecision = false;
+    LiteSyncRecoveryDecision recoveryDecision;
+};
+
+struct LiteWalletSyncAppRefreshCancellationInput {
+    bool cancellationRequested = false;
+    bool syncInProgress = false;
+    bool cancellationSupported = false;
+};
+
+struct LiteWalletFutureWorkerQueueInput {
+    bool enabled = true;
+    std::size_t queueDepth = 0;
+    std::size_t maxQueueDepth = 0;
+    std::string laneName = "lite-app-refresh";
+};
+
+struct LiteWalletSyncAppRefreshIntegrationInput {
+    LiteWalletSyncAppRefreshLifecycleInput lifecycle;
+    LiteWalletSyncAppRefreshSyncPlanInput sync;
+    LiteWalletSyncAppRefreshCancellationInput cancellation;
+    LiteWalletFutureWorkerQueueInput futureWorkerQueue;
+    LiteWalletAppRefreshOrchestrationResult refreshOrchestration;
+};
+
+struct LiteWalletSyncAppRefreshIntegrationOptions {
+    bool requireLifecycleReady = true;
+    bool requireSyncStartPlan = true;
+    bool requireSyncStatusPlan = true;
+    bool requireRecoveryDecision = true;
+    bool requireSyncCompleteForRefresh = true;
+    bool rejectExecutableSyncPlans = true;
+    bool requireFutureWorkerQueue = true;
+};
+
+struct LiteWalletFutureWorkerQueuePlan {
+    bool readyToFeed = false;
+    bool wouldFeed = false;
+    bool enqueued = false;
+    std::string laneName;
+    LiteWalletAppRefreshScheduleTrigger trigger = LiteWalletAppRefreshScheduleTrigger::Periodic;
+    LiteWalletRefreshRouteKind route = LiteWalletRefreshRouteKind::Unavailable;
+    std::string startSyncCommand;
+    std::string syncStatusCommand;
+    std::size_t queueDepth = 0;
+    std::size_t maxQueueDepth = 0;
+};
+
+struct LiteWalletSyncAppRefreshIntegrationIssueInfo {
+    LiteWalletSyncAppRefreshIntegrationIssue issue = LiteWalletSyncAppRefreshIntegrationIssue::LifecycleNotReady;
+    std::string message;
+};
+
+struct LiteWalletSyncAppRefreshIntegrationResult {
+    bool ok = false;
+    bool dryRunOnly = true;
+    bool noNetwork = true;
+    bool noBridgeCalls = true;
+    bool noSyncStarted = true;
+    bool noWalletPersistence = true;
+    bool stateMutationAllowed = false;
+    bool stateMutated = false;
+    bool walletStateWritten = false;
+    bool workerQueueEnqueued = false;
+
+    bool lifecycleAccepted = false;
+    bool syncStartPlanAccepted = false;
+    bool syncStatusPlanAccepted = false;
+    bool recoveryAccepted = false;
+    bool cancellationAccepted = false;
+    bool refreshReportAccepted = false;
+    bool futureWorkerQueueFeedReady = false;
+    bool wouldFeedFutureWorkerQueue = false;
+    bool refreshWouldQueue = false;
+    bool refreshSkipped = false;
+    bool refreshBlocked = false;
+    bool recoveryRequired = false;
+    bool cancellationRequired = false;
+    bool futureClearRequired = false;
+    bool futureRescanRequired = false;
+    bool futureRestartSyncRequired = false;
+    bool requiresUserAttention = false;
+
+    LiteWalletSyncAppRefreshIntegrationStatus status = LiteWalletSyncAppRefreshIntegrationStatus::WaitingForLifecycle;
+    LiteWalletRefreshRouteKind route = LiteWalletRefreshRouteKind::Unavailable;
+    WalletBackendStatus lifecycleStatus;
+    LiteSyncPlan syncStartPlan;
+    LiteSyncPlan syncStatusPlan;
+    LiteSyncRecoveryDecision recoveryDecision;
+    LiteWalletAppRefreshOrchestrationResult refreshOrchestration;
+    LiteWalletFutureWorkerQueuePlan futureWorkerQueuePlan;
+    std::vector<LiteWalletSyncAppRefreshIntegrationIssueInfo> issues;
+    std::string error;
+};
+
+const char* liteWalletSyncAppRefreshIntegrationStatusName(
+    LiteWalletSyncAppRefreshIntegrationStatus status);
+const char* liteWalletSyncAppRefreshIntegrationIssueName(
+    LiteWalletSyncAppRefreshIntegrationIssue issue);
+
+LiteWalletSyncAppRefreshIntegrationResult planLiteWalletSyncAppRefreshIntegration(
+    const LiteWalletSyncAppRefreshIntegrationInput& input,
+    LiteWalletSyncAppRefreshIntegrationOptions options = {});
+
+class LiteWalletSyncAppRefreshIntegrationPlanner {
+public:
+    explicit LiteWalletSyncAppRefreshIntegrationPlanner(
+        LiteWalletSyncAppRefreshIntegrationOptions options = {});
+
+    LiteWalletSyncAppRefreshIntegrationResult plan(
+        const LiteWalletSyncAppRefreshIntegrationInput& input) const;
+
+private:
+    LiteWalletSyncAppRefreshIntegrationOptions options_;
+};
+
+} // namespace dragonx::wallet