req-cli 0.1.1

Managed requirements CLI for LLM agents and humans
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

// Concurrency tests for REQ-0062 (advisory file lock around mutation
// cycles). Spawns multiple child `req` processes and asserts that no
// updates are lost: both writes land with distinct IDs.
mod common;
use common::Sandbox;
use std::process::{Command, Stdio};

fn spawn_add(path: &std::path::Path, title: &str, rationale: &str) -> std::process::Child {
    Command::new(env!("CARGO_BIN_EXE_req"))
        .args([
            "--file",
            path.to_str().unwrap(),
            "add",
            "--title",
            title,
            "--statement",
            "The system shall accept this concurrent requirement attempt for the lock test.",
            "--rationale",
            rationale,
            "--kind",
            "constraint",
            "--priority",
            "could",
        ])
        .stdout(Stdio::piped())
        .stderr(Stdio::piped())
        .spawn()
        .expect("spawn child")
}

#[test]
fn req_0062_two_concurrent_adds_both_land_with_distinct_ids() {
    let s = Sandbox::new();
    s.init("conc");
    let path = s.path();
    let a = spawn_add(&path, "Concurrent requirement A here", "Process A");
    let b = spawn_add(&path, "Concurrent requirement B here", "Process B");
    let oa = a.wait_with_output().expect("A finished");
    let ob = b.wait_with_output().expect("B finished");
    assert!(
        oa.status.success(),
        "A stderr: {}",
        String::from_utf8_lossy(&oa.stderr)
    );
    assert!(
        ob.status.success(),
        "B stderr: {}",
        String::from_utf8_lossy(&ob.stderr)
    );

    let list = common::stdout(&s.run(&["list", "--json"]));
    assert!(list.contains("REQ-0001"), "REQ-0001 missing from: {}", list);
    assert!(
        list.contains("REQ-0002"),
        "REQ-0002 missing — lost update! list: {}",
        list
    );
}

#[test]
fn req_0062_five_concurrent_adds_all_land_with_unique_ids() {
    let s = Sandbox::new();
    s.init("conc");
    let path = s.path();
    let children: Vec<_> = (0..5)
        .map(|i| {
            spawn_add(
                &path,
                &format!("Concurrent requirement number {}", i),
                &format!("P{}", i),
            )
        })
        .collect();
    let mut ok = 0;
    for (i, c) in children.into_iter().enumerate() {
        let out = c.wait_with_output().expect("child wait");
        if out.status.success() {
            ok += 1
        } else {
            eprintln!(
                "child {} stderr: {}",
                i,
                String::from_utf8_lossy(&out.stderr)
            );
        }
    }
    assert_eq!(ok, 5, "all five concurrent adds should succeed");

    let list = common::stdout(&s.run(&["list", "--json"]));
    for i in 1..=5 {
        let want = format!("REQ-{:04}", i);
        assert!(list.contains(&want), "{} missing — lost update", want);
    }
}

#[test]
fn req_0062_lock_sidecar_persists_between_acquires() {
    // Inverted from the original "is cleaned up" assertion: on Windows,
    // deleting the sidecar after release lets a contending process
    // attach to a fresh inode at the same path and silently break
    // exclusion. The sidecar is intentionally persistent now and lives
    // in .gitignore so it never reaches a commit.
    let s = Sandbox::new();
    s.init("conc");
    let _ = s.run(&[
        "add",
        "--title",
        "Single add holds the lock end to end",
        "--statement",
        "The system shall hold the advisory lock for the full load-modify-save cycle.",
        "--rationale",
        "Verify the sidecar persists.",
        "--kind",
        "constraint",
        "--priority",
        "could",
    ]);
    let dir = s.dir.path();
    let lock_present = std::fs::read_dir(dir)
        .unwrap()
        .filter_map(|e| e.ok())
        .any(|e| e.file_name().to_string_lossy().ends_with(".lock"));
    assert!(
        lock_present,
        "lock sidecar should remain on disk after release so contending \
         processes attach to the same inode (Windows correctness)"
    );
}