meld 1.1.1

Deterministic filesystem state management using Merkle trees
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
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

//! Shared types for workspace commands and status.

use serde::{Deserialize, Serialize};
use std::path::PathBuf;

/// Parameters for workspace status command; aligns with agent/provider status pattern.
#[derive(Debug, Clone)]
pub struct WorkspaceStatusRequest {
    pub workspace_root: PathBuf,
    pub store_path: PathBuf,
    pub include_breakdown: bool,
}

/// Workspace status: not-scanned or scanned with tree, coverage, top paths.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct WorkspaceStatus {
    pub scanned: bool,
    pub store_path: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub message: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub tree: Option<TreeStatus>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub context_coverage: Option<Vec<ContextCoverageEntry>>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub top_paths_by_node_count: Option<Vec<PathCount>>,
}

/// Result type for workspace status command; aligns with AgentStatusEntryResult / ProviderStatusEntryResult naming.
pub type WorkspaceStatusResult = WorkspaceStatus;

/// Tree section when scanned.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TreeStatus {
    pub root_hash: String,
    pub total_nodes: u64,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub breakdown: Option<Vec<PathCount>>,
}

/// Path prefix and node count.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PathCount {
    pub path: String,
    pub nodes: u64,
}

/// Per-agent context coverage when scanned.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ContextCoverageEntry {
    pub agent_id: String,
    pub nodes_with_frame: u64,
    pub nodes_without_frame: u64,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub coverage_pct: Option<u64>,
}

// --- Agent status (for unified status) ---

/// One row for agent status table / JSON.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AgentStatusEntry {
    pub agent_id: String,
    pub role: String,
    pub valid: bool,
    pub prompt_path_exists: bool,
}

/// Agent status output for JSON.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AgentStatusOutput {
    pub agents: Vec<AgentStatusEntry>,
    pub total: usize,
    pub valid_count: usize,
}

// --- Provider status (for unified status) ---

/// One row for provider status table / JSON.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ProviderStatusEntry {
    pub provider_name: String,
    pub provider_type: String,
    pub model: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub connectivity: Option<String>,
}

/// Provider status output for JSON.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ProviderStatusOutput {
    pub providers: Vec<ProviderStatusEntry>,
    pub total: usize,
}

// --- Unified status ---

/// Unified status output combining workspace, agents, and providers.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct UnifiedStatusOutput {
    #[serde(skip_serializing_if = "Option::is_none")]
    pub workspace: Option<WorkspaceStatus>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub agents: Option<AgentStatusOutput>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub providers: Option<ProviderStatusOutput>,
}

// --- Command result DTOs (for CLI formatting) ---

/// Result of workspace validate command.
#[derive(Debug, Clone, Serialize)]
pub struct ValidateResult {
    pub valid: bool,
    pub root_hash: String,
    pub node_count: usize,
    pub frame_count: usize,
    pub errors: Vec<String>,
    pub warnings: Vec<String>,
}

/// Result of workspace ignore command: list entries or single added path.
#[derive(Debug, Clone, Serialize)]
pub enum IgnoreResult {
    List { entries: Vec<String> },
    Added { path: String },
}

/// One row for list_deleted output.
#[derive(Debug, Clone, Serialize)]
pub struct ListDeletedRow {
    pub path: String,
    pub node_id_short: String,
    pub tombstoned_at: u64,
    pub age: String,
}

/// Result of workspace list_deleted command.
#[derive(Debug, Clone, Serialize)]
pub struct ListDeletedResult {
    pub rows: Vec<ListDeletedRow>,
}