wsb-daemon 0.258.6441

wsb's daemon: the workbench, the GitHub mirror's schedule and peer continuity, for every workspace on the machine
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
use wsb::prelude::*;
use axum::{extract::State, http::StatusCode, Json};
use std::{
    collections::HashMap,
    path::{Path, PathBuf},
};

use super::sessions::ErrorResponse;
use crate::web::home_dir;
use crate::web::state::WebState;
use wsb::state::StateConfig;
use wsb::workspace_state::{WorkspaceState, WstemplateEntry};

#[derive(Debug, Serialize, Deserialize)]
pub struct TerminalSettings {
    pub mode: String,
    #[serde(default)]
    pub custom_bin: Option<String>,
    #[serde(default)]
    pub custom_args: Option<String>,
}

impl Default for TerminalSettings {
    fn default() -> Self {
        Self {
            mode: "auto".to_string(),
            custom_bin: None,
            custom_args: None,
        }
    }
}

/// Where this daemon is actually serving from.
///
/// Reported, never set. Which address the workbench is reachable on is decided
/// when the daemon starts — `wsb serve --listen` — and not by anything a page
/// can switch on.
///
/// It used to carry a `remote_access` flag the page could toggle and persist.
/// Nothing read it: the server bound loopback either way, so the toggle
/// promised remote access it never delivered — and had anything honoured it,
/// a box ticked once would have quietly reopened the port on every restart
/// afterwards.
#[derive(Debug, Serialize, Deserialize)]
pub struct ServerSettings {
    /// The bound address: `127.0.0.1` for a daemon only this machine can
    /// reach, `0.0.0.0` for one every interface can.
    pub host: String,
    pub port: u16,
    /// Whether that address reaches beyond this machine. Derived from `host`
    /// rather than stored, so it cannot disagree with where the socket is.
    pub reachable_remotely: bool,
}

#[derive(Debug, Serialize, Deserialize)]
pub struct WorkspaceSettings {
    pub root: String,
    pub project_name: Option<String>,
    pub tools: HashMap<String, serde_json::Value>,
    #[serde(default)]
    pub wstemplate_entry: Option<WstemplateEntryPayload>,
}

#[derive(Debug, Serialize, Deserialize)]
pub struct WstemplateEntryPayload {
    pub root: String,
    pub alias: String,
}

#[derive(Debug, Serialize, Deserialize)]
pub struct ProjectSettings {
    pub state: StateConfig,
}

/// The logs directory: where it is, how big it may get, and what it holds.
///
/// Every operation started from the workbench is written to a file there, so
/// this is the one setting that decides how much of the past a page can still
/// show. The root is reported and not settable — it is under the worktree
/// that produced the logs — and the usage is measured on
/// every read rather than remembered, because the thing it describes is a
/// directory that other processes also write to.
#[derive(Debug, Serialize, Deserialize)]
pub struct LogsSettings {
    /// Absolute path of the logs root.
    pub root: String,
    /// The ceiling on the whole directory. Older entries are removed as it is
    /// approached, oldest first.
    pub max_bytes: u64,
    /// The smallest limit that may be set, so the page can say so rather than
    /// letting a value be rejected after it is typed.
    pub min_bytes: u64,
    pub usage: wsb::logs::Usage,
}

#[derive(Debug, Serialize, Deserialize)]
pub struct AppSettings {
    pub workspace: WorkspaceSettings,
    pub project: ProjectSettings,
    pub agent_dirs: HashMap<String, Vec<String>>,
    pub terminal: TerminalSettings,
    pub server: ServerSettings,
    pub logs: LogsSettings,
}

#[derive(Debug, Deserialize)]
pub struct UpdateSettingsRequest {
    #[serde(default)]
    pub workspace: Option<WorkspaceSettingsUpdate>,
    #[serde(default)]
    pub project: Option<ProjectSettingsUpdate>,
    #[serde(default)]
    pub terminal: Option<TerminalSettingsUpdate>,
    #[serde(default)]
    pub logs: Option<LogsSettingsUpdate>,
}

#[derive(Debug, Deserialize)]
pub struct LogsSettingsUpdate {
    pub max_bytes: u64,
}

#[derive(Debug, Deserialize)]
pub struct WorkspaceSettingsUpdate {
    #[serde(default)]
    pub project_name: Option<String>,
    #[serde(default)]
    pub tools: Option<HashMap<String, serde_json::Value>>,
    #[serde(default)]
    pub wstemplate_entry: Option<Option<WstemplateEntryPayload>>,
}

#[derive(Debug, Deserialize)]
pub struct ProjectSettingsUpdate {
    #[serde(default)]
    pub state: Option<StateConfig>,
}

#[derive(Debug, Deserialize)]
pub struct TerminalSettingsUpdate {
    pub mode: String,
    #[serde(default)]
    pub custom_bin: Option<String>,
    #[serde(default)]
    pub custom_args: Option<String>,
}

#[derive(Default)]
struct UserConfig {
    terminal: TerminalSettings,
    logs: LogsConfig,
}

/// The part of the logs policy a person sets. Everything else about the
/// directory is measured or declared.
#[derive(Debug, Clone, Copy)]
struct LogsConfig {
    max_bytes: u64,
}

impl Default for LogsConfig {
    fn default() -> Self {
        Self {
            max_bytes: wsb::logs::DEFAULT_MAX_BYTES,
        }
    }
}

/// The limit in force, for the sweeper — which runs on a timer and has no
/// request to read it from.
///
/// Read from the file on every call rather than cached: the limit is changed
/// from a page, and a sweeper holding a copy from startup would keep enforcing
/// the old number until the daemon restarted.
pub fn configured_max_bytes() -> u64 {
    load_user_config()
        .map(|config| config.logs.max_bytes)
        .unwrap_or(wsb::logs::DEFAULT_MAX_BYTES)
        .max(wsb::logs::MIN_MAX_BYTES)
}

/// A worktree wsb has not been set up in has no settings to read or write:
/// an ordinary state of a checkout `prj` made, refused by name rather than
/// failing as an error of the server's.
fn require_set_up(root: &Path) -> Result<(), (StatusCode, Json<ErrorResponse>)> {
    if root.join(".wsb").join("state.json").is_file() {
        Ok(())
    } else {
        Err((
            StatusCode::CONFLICT,
            Json(ErrorResponse {
                error: format!(
                    "wsb is not set up in {}: run `wsb init` there to give it settings",
                    root.display()
                ),
            }),
        ))
    }
}

pub async fn get_settings(
    State(state): State<WebState>,
) -> Result<Json<AppSettings>, (StatusCode, Json<ErrorResponse>)> {
    let repo_root = workspace_root_of(&state);
    require_set_up(&repo_root)?;
    let settings = load_settings(&repo_root, state.listen, state.port)
        .await
        .map_err(internal_error)?;
    Ok(Json(settings))
}

pub async fn update_settings(
    State(state): State<WebState>,
    Json(body): Json<UpdateSettingsRequest>,
) -> Result<Json<AppSettings>, (StatusCode, Json<ErrorResponse>)> {
    let repo_root = workspace_root_of(&state);
    require_set_up(&repo_root)?;
    apply_settings_update(&repo_root, &state, body)
        .await
        .map(Json)
        .map_err(internal_error)
}

async fn load_settings(
    repo_root: &Path,
    listen: std::net::IpAddr,
    port: u16,
) -> anyhow::Result<AppSettings> {
    let logs = logs_settings(repo_root).await?;
    let repo_root_owned = repo_root.to_path_buf();
    let (workspace, user_config) = tokio::task::spawn_blocking(move || {
        let workspace = WorkspaceState::load(&repo_root_owned)?;
        let user_config = load_user_config()?;
        anyhow::Ok((workspace, user_config))
    })
    .await??;
    let state = StateConfig::load_async(repo_root).await?;
    let entry = workspace.effective_wstemplate_entry();
    let wstemplate_entry = Some(WstemplateEntryPayload {
        root: entry.root.display().to_string(),
        alias: entry.alias,
    });

    Ok(AppSettings {
        workspace: WorkspaceSettings {
            root: repo_root.display().to_string(),
            project_name: workspace.project_name,
            tools: workspace.tools,
            wstemplate_entry,
        },
        project: ProjectSettings { state },
        agent_dirs: load_agent_dirs()?,
        terminal: user_config.terminal,
        server: ServerSettings {
            host: listen.to_string(),
            port,
            reachable_remotely: !listen.is_loopback(),
        },
        logs,
    })
}

/// Where the logs are, what they may grow to, and what they hold right now.
///
/// The usage is a walk of the directory, so it happens off the runtime: a
/// settings page that blocked the server while counting a gigabyte of test
/// sessions would be a settings page that hangs on the machines it matters on.
async fn logs_settings(repo_root: &Path) -> anyhow::Result<LogsSettings> {
    let root = repo_root.to_path_buf();
    let (logs_root, usage, max_bytes) = tokio::task::spawn_blocking(move || {
        let logs_root = wsb::logs::root(&root);
        let usage = wsb::logs::usage(&logs_root);
        (logs_root, usage, configured_max_bytes())
    })
    .await?;
    Ok(LogsSettings {
        root: logs_root.display().to_string(),
        max_bytes,
        min_bytes: wsb::logs::MIN_MAX_BYTES,
        usage,
    })
}

async fn apply_settings_update(
    repo_root: &Path,
    state: &WebState,
    body: UpdateSettingsRequest,
) -> anyhow::Result<AppSettings> {
    if let Some(workspace_update) = body.workspace {
        let repo_root_owned = repo_root.to_path_buf();
        let mut workspace =
            tokio::task::spawn_blocking(move || WorkspaceState::load(&repo_root_owned)).await??;
        if let Some(project_name) = workspace_update.project_name {
            let trimmed = project_name.trim();
            if trimmed.is_empty() {
                anyhow::bail!("workspace.project_name cannot be empty");
            }
            workspace.project_name = Some(trimmed.to_string());
        }
        if let Some(tools) = workspace_update.tools {
            workspace.tools = tools;
        }
        if let Some(wstemplate_entry) = workspace_update.wstemplate_entry {
            match wstemplate_entry {
                Some(entry) => {
                    let alias = entry.alias.trim();
                    let root = entry.root.trim();
                    if alias.is_empty() {
                        anyhow::bail!("workspace.wstemplate_entry.alias cannot be empty");
                    }
                    if root.is_empty() {
                        anyhow::bail!("workspace.wstemplate_entry.root cannot be empty");
                    }
                    workspace.set_wstemplate_entry(WstemplateEntry {
                        alias: alias.to_string(),
                        root: PathBuf::from(root),
                    });
                }
                None => workspace.clear_wstemplate_entry(),
            }
        }
        let repo_root_save = repo_root.to_path_buf();
        tokio::task::spawn_blocking(move || workspace.save(&repo_root_save)).await??;
    }

    if let Some(project_update) = body.project {
        if let Some(project_state) = project_update.state {
            project_state.save_async(repo_root).await?;
        }
    }

    if let Some(logs_update) = body.logs {
        validate_logs_update(logs_update.max_bytes)?;
        let max_bytes = logs_update.max_bytes;
        tokio::task::spawn_blocking(move || {
            update_user_config(|table| set_logs_table(table, max_bytes))
        })
        .await??;
        // Enforced NOW. A new limit that takes effect at the next operation is
        // a limit somebody lowers to reclaim disk and then watches not reclaim
        // any, with nothing to say why.
        crate::web::log_janitor::sweep_now(state).await;
    }

    if let Some(terminal_update) = body.terminal {
        validate_terminal_settings(&terminal_update)?;
        let terminal = TerminalSettings {
            mode: terminal_update.mode.clone(),
            custom_bin: terminal_update.custom_bin.clone(),
            custom_args: terminal_update.custom_args.clone(),
        };
        tokio::task::spawn_blocking(move || {
            update_user_config(|table| set_terminal_table(table, &terminal))
        })
        .await??;
    }

    load_settings(repo_root, state.listen, state.port).await
}

fn load_agent_dirs() -> anyhow::Result<HashMap<String, Vec<String>>> {
    let home = home_dir()?;
    let mut dirs = HashMap::new();
    dirs.insert(
        "claude".to_string(),
        vec![home.join(".claude").join("projects").display().to_string()],
    );
    Ok(dirs)
}

fn load_user_config() -> anyhow::Result<UserConfig> {
    let path = user_config_path()?;
    if !path.exists() {
        return Ok(UserConfig::default());
    }

    let content = std::fs::read_to_string(&path)?;
    let table: toml::Table = content.parse()?;

    let terminal = table
        .get("terminal")
        .and_then(toml::Value::as_table)
        .map(parse_terminal_table)
        .transpose()?
        .unwrap_or_default();

    // A limit below the floor is raised to it rather than refused: the file is
    // hand-editable, and a daemon that will not start because somebody typed a
    // small number is worse than one that says what it is enforcing.
    let logs = table
        .get("logs")
        .and_then(toml::Value::as_table)
        .and_then(|logs| logs.get("max_bytes"))
        .and_then(toml::Value::as_integer)
        .filter(|bytes| *bytes > 0)
        .map(|bytes| LogsConfig {
            max_bytes: (bytes as u64).max(wsb::logs::MIN_MAX_BYTES),
        })
        .unwrap_or_default();

    Ok(UserConfig { terminal, logs })
}

fn parse_terminal_table(table: &toml::Table) -> anyhow::Result<TerminalSettings> {
    let mode = table
        .get("mode")
        .and_then(toml::Value::as_str)
        .unwrap_or("auto")
        .to_string();
    let custom_bin = table
        .get("custom_bin")
        .and_then(toml::Value::as_str)
        .map(ToString::to_string);
    let custom_args = table
        .get("custom_args")
        .and_then(toml::Value::as_str)
        .map(ToString::to_string);

    let terminal = TerminalSettings {
        mode,
        custom_bin,
        custom_args,
    };
    validate_terminal_settings(&TerminalSettingsUpdate {
        mode: terminal.mode.clone(),
        custom_bin: terminal.custom_bin.clone(),
        custom_args: terminal.custom_args.clone(),
    })?;
    Ok(terminal)
}

fn validate_terminal_settings(terminal: &TerminalSettingsUpdate) -> anyhow::Result<()> {
    match terminal.mode.as_str() {
        "auto" | "custom" | "clipboard" => {}
        other => anyhow::bail!(
            "terminal.mode must be one of auto, custom, clipboard; got '{}'",
            other
        ),
    }
    if terminal.mode == "custom" {
        if terminal
            .custom_bin
            .as_ref()
            .map(|value| value.trim().is_empty())
            .unwrap_or(true)
        {
            anyhow::bail!("terminal.custom_bin is required when terminal.mode is 'custom'");
        }
    }
    Ok(())
}

/// Refuse a limit that would make the workbench appear to lose output.
///
/// Separate from the handler so it can be tested without a server: the number
/// is the only part of this that can be wrong in a way somebody notices weeks
/// later, as logs that vanish while they are being read.
fn validate_logs_update(max_bytes: u64) -> anyhow::Result<()> {
    if max_bytes < wsb::logs::MIN_MAX_BYTES {
        anyhow::bail!(
            "the logs limit cannot be below {} — a limit smaller than one run's output \
             removes the log a page is showing as fast as it is written",
            wsb::logs::human_bytes(wsb::logs::MIN_MAX_BYTES)
        );
    }
    Ok(())
}

/// Write the logs limit into the user's config file.
fn set_logs_table(table: &mut toml::Table, max_bytes: u64) {
    let logs_table = table
        .entry("logs".to_string())
        .or_insert_with(|| toml::Value::Table(toml::Table::new()));
    let logs_table = logs_table
        .as_table_mut()
        .expect("logs entry must remain a table");
    logs_table.insert(
        "max_bytes".to_string(),
        toml::Value::Integer(max_bytes as i64),
    );
}

fn set_terminal_table(table: &mut toml::Table, terminal: &TerminalSettings) {
    let terminal_table = table
        .entry("terminal".to_string())
        .or_insert_with(|| toml::Value::Table(toml::Table::new()));
    let terminal_table = terminal_table
        .as_table_mut()
        .expect("terminal entry must remain a table");
    terminal_table.insert(
        "mode".to_string(),
        toml::Value::String(terminal.mode.clone()),
    );
    match &terminal.custom_bin {
        Some(custom_bin) => {
            terminal_table.insert(
                "custom_bin".to_string(),
                toml::Value::String(custom_bin.clone()),
            );
        }
        None => {
            terminal_table.remove("custom_bin");
        }
    }
    match &terminal.custom_args {
        Some(custom_args) => {
            terminal_table.insert(
                "custom_args".to_string(),
                toml::Value::String(custom_args.clone()),
            );
        }
        None => {
            terminal_table.remove("custom_args");
        }
    }
}

fn update_user_config(mut apply: impl FnMut(&mut toml::Table)) -> anyhow::Result<()> {
    let path = user_config_path()?;
    if let Some(parent) = path.parent() {
        std::fs::create_dir_all(parent)?;
    }
    let mut table: toml::Table = if path.exists() {
        std::fs::read_to_string(&path)?.parse()?
    } else {
        toml::Table::new()
    };
    apply(&mut table);
    std::fs::write(&path, toml::to_string_pretty(&table)?)?;
    Ok(())
}

/// The machine's settings: `config.toml` in the machine directory, beside
/// the daemon that reads them.
fn user_config_path() -> anyhow::Result<PathBuf> {
    Ok(wsb::daemon::machine_dir()
        .map_err(|e| anyhow::anyhow!(e))?
        .join("config.toml"))
}

/// The workspace these routes act on, from the state they were reached
/// through — not from the process's directory, which belongs to no workspace
/// now that one daemon serves the machine.
fn workspace_root_of(state: &WebState) -> PathBuf {
    state.workspace_root.clone()
}

fn internal_error(error: impl ToString) -> (StatusCode, Json<ErrorResponse>) {
    (
        StatusCode::INTERNAL_SERVER_ERROR,
        Json(ErrorResponse {
            error: error.to_string(),
        }),
    )
}

#[cfg(test)]
mod tests {
    use super::*;
    use std::sync::{Mutex, OnceLock};
    use tempfile::TempDir;


    /// TEST8997: the settings page reports the logs directory that is
    /// actually written to.
    ///
    /// A settings page that showed a different path — a remembered one, a
    /// default it computed itself — would send somebody to an empty directory
    /// to look for the log of an operation they just watched run.
    #[tokio::test]
    async fn test8997_the_reported_root_is_the_one_that_is_written() {
        let dir = tempfile::tempdir().unwrap();
        let settings = logs_settings(dir.path()).await.expect("settings load");

        assert_eq!(
            settings.root,
            wsb::logs::root(dir.path()).display().to_string()
        );
        assert!(settings.max_bytes >= settings.min_bytes);
        assert_eq!(settings.min_bytes, wsb::logs::MIN_MAX_BYTES);
        // Every stream is named even when nothing has been written yet: a
        // page listing only non-empty ones reads as if the others do not
        // exist.
        for stream in wsb::logs::Stream::ALL {
            assert!(settings.usage.by_group.contains_key(stream.dir_name()));
        }
    }

    /// TEST8998: a limit below the floor is refused, and says why.
    #[test]
    fn test8998_a_limit_below_the_floor_is_refused() {
        let error = validate_logs_update(1024).expect_err("a 1 KB limit is not a limit");
        let message = error.to_string();
        assert!(message.contains("cannot be below"), "{message}");
        assert!(
            message.contains("removes the log a page is showing"),
            "the refusal has to say what would go wrong: {message}"
        );
        validate_logs_update(wsb::logs::MIN_MAX_BYTES).expect("the floor itself is allowed");
        validate_logs_update(wsb::logs::DEFAULT_MAX_BYTES).expect("the default is allowed");
    }

    static SETTINGS_TEST_LOCK: OnceLock<Mutex<()>> = OnceLock::new();

    #[test]
    fn load_settings_reads_workspace_project_and_user_config() {
        let _guard = SETTINGS_TEST_LOCK
            .get_or_init(|| Mutex::new(()))
            .lock()
            .unwrap_or_else(|poisoned| poisoned.into_inner());
        let repo = TempDir::new().unwrap();
        let machine = TempDir::new().unwrap();

        wsb::git_backend::init_repository(repo.path()).unwrap();
        std::fs::create_dir_all(repo.path().join(".wsb")).unwrap();
        let mut workspace_state =
            WorkspaceState::initialize(repo.path(), Some("machinefabric")).unwrap();
        workspace_state
            .set_tool_config("state", &serde_json::json!({ "profile": "prod" }))
            .unwrap();
        workspace_state.set_wstemplate_entry(WstemplateEntry {
            alias: "mf".to_string(),
            root: repo.path().to_path_buf(),
        });
        workspace_state.save(repo.path()).unwrap();

        let _ = StateConfig::load(repo.path()).unwrap();
        let project_state = StateConfig {
            version: 7,
            enabled: true,
            version_file: "VERSION".to_string(),
            auto_detect_project_files: false,
            project_files: vec!["Cargo.toml".to_string()],
        };
        project_state.save(repo.path()).unwrap();

        std::fs::write(
            machine.path().join("config.toml"),
            r#"
[terminal]
mode = "custom"
custom_bin = "/usr/bin/kitty"
custom_args = "-- bash -lc {cmd}"
"#,
        )
        .unwrap();

        let old_machine = std::env::var_os(wsb::daemon::machine::MACHINE_DIR_ENV);
        std::env::set_var(wsb::daemon::machine::MACHINE_DIR_ENV, machine.path());

        let rt = tokio::runtime::Runtime::new().unwrap();
        let settings = rt
            .block_on(load_settings(
                repo.path(),
                std::net::IpAddr::V4(std::net::Ipv4Addr::LOCALHOST),
                4123,
            ))
            .unwrap();

        match old_machine {
            Some(value) => std::env::set_var(wsb::daemon::machine::MACHINE_DIR_ENV, value),
            None => std::env::remove_var(wsb::daemon::machine::MACHINE_DIR_ENV),
        }

        assert_eq!(settings.workspace.root, repo.path().display().to_string());
        assert_eq!(
            settings.workspace.project_name.as_deref(),
            Some("machinefabric")
        );
        assert_eq!(
            settings.workspace.tools.get("state"),
            Some(&serde_json::json!({ "profile": "prod" }))
        );
        assert_eq!(
            settings
                .workspace
                .wstemplate_entry
                .as_ref()
                .map(|entry| entry.alias.as_str()),
            Some("mf")
        );
        assert_eq!(settings.project.state.version, 1);
        assert_eq!(settings.project.state.version_file, "VERSION");
        assert!(!settings.project.state.auto_detect_project_files);
        assert_eq!(
            settings.project.state.project_files,
            vec!["Cargo.toml".to_string()]
        );
        assert_eq!(settings.terminal.mode, "custom");
        assert_eq!(
            settings.terminal.custom_bin.as_deref(),
            Some("/usr/bin/kitty")
        );
        assert_eq!(settings.server.port, 4123);
        // Reported from the socket, not from the file: the [server] section
        // above says remote_access = true, and this daemon is on loopback.
        assert_eq!(settings.server.host, "127.0.0.1");
        assert!(!settings.server.reachable_remotely);
    }

    /// A daemon started with `--listen` reports where it actually is.
    #[test]
    fn server_settings_report_the_address_the_daemon_is_bound_to() {
        let _guard = SETTINGS_TEST_LOCK
            .get_or_init(|| Mutex::new(()))
            .lock()
            .unwrap_or_else(|poisoned| poisoned.into_inner());
        let repo = TempDir::new().unwrap();
        let machine = TempDir::new().unwrap();

        // A whole workspace, because `load_settings` reads one: its state, its
        // project configuration and the machine's settings all have to be there
        // before it can report anything about the server.
        wsb::git_backend::init_repository(repo.path()).unwrap();
        std::fs::create_dir_all(repo.path().join(".wsb")).unwrap();
        let workspace_state =
            WorkspaceState::initialize(repo.path(), Some("machinefabric")).unwrap();
        workspace_state.save(repo.path()).unwrap();
        let _ = StateConfig::load(repo.path()).unwrap();

        let old_machine = std::env::var_os(wsb::daemon::machine::MACHINE_DIR_ENV);
        std::env::set_var(wsb::daemon::machine::MACHINE_DIR_ENV, machine.path());

        let rt = tokio::runtime::Runtime::new().unwrap();
        let settings = rt
            .block_on(load_settings(
                repo.path(),
                std::net::IpAddr::V4(std::net::Ipv4Addr::UNSPECIFIED),
                4123,
            ))
            .unwrap();

        match old_machine {
            Some(value) => std::env::set_var(wsb::daemon::machine::MACHINE_DIR_ENV, value),
            None => std::env::remove_var(wsb::daemon::machine::MACHINE_DIR_ENV),
        }

        assert_eq!(settings.server.host, "0.0.0.0");
        assert!(
            settings.server.reachable_remotely,
            "a daemon on every interface must say so: the page warns about it, \
             and nothing else in the workbench asks for a password"
        );
    }

    #[test]
    fn update_user_config_persists_terminal_settings() {
        let _guard = SETTINGS_TEST_LOCK
            .get_or_init(|| Mutex::new(()))
            .lock()
            .unwrap_or_else(|poisoned| poisoned.into_inner());
        let machine = TempDir::new().unwrap();
        let old_machine = std::env::var_os(wsb::daemon::machine::MACHINE_DIR_ENV);
        std::env::set_var(wsb::daemon::machine::MACHINE_DIR_ENV, machine.path());

        update_user_config(|table| {
            set_terminal_table(
                table,
                &TerminalSettings {
                    mode: "clipboard".to_string(),
                    custom_bin: None,
                    custom_args: None,
                },
            );
        })
        .unwrap();

        let config = load_user_config().unwrap();

        match old_machine {
            Some(value) => std::env::set_var(wsb::daemon::machine::MACHINE_DIR_ENV, value),
            None => std::env::remove_var(wsb::daemon::machine::MACHINE_DIR_ENV),
        }

        assert_eq!(config.terminal.mode, "clipboard");
    }

    #[tokio::test]
    async fn state_config_async_round_trip_works_inside_runtime() {
        let repo = TempDir::new().unwrap();
        wsb::git_backend::init_repository(repo.path()).unwrap();
        std::fs::create_dir_all(repo.path().join(".wsb")).unwrap();

        let initial = StateConfig::load_async(repo.path()).await.unwrap();
        assert_eq!(initial.version_file, "version.txt");

        let updated = StateConfig {
            version: 1,
            enabled: true,
            version_file: "VERSION".to_string(),
            auto_detect_project_files: false,
            project_files: vec!["Cargo.toml".to_string()],
        };
        updated.save_async(repo.path()).await.unwrap();

        let loaded = StateConfig::load_async(repo.path()).await.unwrap();
        assert_eq!(loaded.version_file, "VERSION");
        assert!(!loaded.auto_detect_project_files);
        assert_eq!(loaded.project_files, vec!["Cargo.toml".to_string()]);
    }
}