lazyspec 0.8.0

A little TUI & CLI for project documentation.
Documentation 
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

mod common;

use lazyspec::engine::config::{Config, StoreBackend};
use lazyspec::engine::store::Store;
use lazyspec::engine::validation::ValidationIssue;

fn config_with_git_ref_iterations() -> Config {
    let mut config = Config::default();
    for t in &mut config.documents.types {
        if t.name == "iteration" {
            t.store = StoreBackend::GitRef;
        }
    }
    config
}

#[test]
fn validate_catches_issues_in_git_ref_docs() {
    let fixture = common::TestFixture::new();
    let config = config_with_git_ref_iterations();

    let cache_dir = fixture.root().join(".lazyspec/cache/iteration");
    std::fs::create_dir_all(&cache_dir).unwrap();

    // Iteration with no implements link -- triggers MissingParentLink
    std::fs::write(
        cache_dir.join("ITERATION-001-orphan.md"),
        "---\ntitle: \"Orphan Iteration\"\ntype: iteration\nstatus: draft\nauthor: \"test\"\ndate: 2026-01-01\ntags: []\n---\n",
    )
    .unwrap();

    let store = Store::load(fixture.root(), &config).unwrap();
    let result = store.validate_full(&config);

    let has_missing_parent = result
        .errors
        .iter()
        .any(|e| matches!(e, ValidationIssue::MissingParentLink { .. }));
    assert!(
        has_missing_parent,
        "git-ref iteration without parent link should produce MissingParentLink error, got: {:?}",
        result.errors
    );
}

#[test]
fn validate_passes_for_valid_git_ref_docs() {
    let fixture = common::TestFixture::new();
    let config = config_with_git_ref_iterations();

    // Story lives on filesystem as usual
    fixture.write_story("STORY-001.md", "A Story", "draft", None);

    let cache_dir = fixture.root().join(".lazyspec/cache/iteration");
    std::fs::create_dir_all(&cache_dir).unwrap();

    // Iteration in git-ref cache with valid implements link to the story
    std::fs::write(
        cache_dir.join("ITERATION-001-valid.md"),
        "---\ntitle: \"Valid Iteration\"\ntype: iteration\nstatus: draft\nauthor: \"test\"\ndate: 2026-01-01\ntags: []\nrelated:\n- implements: STORY-001\n---\n",
    )
    .unwrap();

    let store = Store::load(fixture.root(), &config).unwrap();
    let result = store.validate_full(&config);

    let iteration_errors: Vec<_> = result
        .errors
        .iter()
        .filter(|e| match e {
            ValidationIssue::MissingParentLink { child_type, .. } => child_type == "iteration",
            ValidationIssue::BrokenLink { source, .. } => {
                source.to_string_lossy().contains("ITERATION")
            }
            _ => false,
        })
        .collect();

    assert!(
        iteration_errors.is_empty(),
        "valid git-ref iteration should not produce iteration-specific errors, got: {:?}",
        iteration_errors
    );
}