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
//! Store abstraction for Decapod's state management.
//!
//! This module provides the fundamental data model for Decapod's dual-store architecture.
//! Two store types are supported: User (local mutable) and Repo (project-scoped deterministic).
use crate::core::error;
use crate::core::workspace;
use std::path::{Path, PathBuf};
/// Store type discriminator for dual-store architecture.
///
/// Decapod maintains two distinct stores with different semantics:
/// - `User`: Agent-local state (blank slate, no automatic seeding)
/// - `Repo`: Project-scoped state (dogfood backlog, event-sourced, deterministic rebuild)
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum StoreKind {
/// User store: Agent-local workspace at `~/.decapod/data/`
User,
/// Repo store: Project-scoped workspace at `<repo>/.decapod/data/`
Repo,
}
/// Store handle representing a Decapod state workspace.
///
/// A Store is a logical container for Decapod's state databases and event logs.
/// All subsystem state (TODO, health, knowledge, etc.) is scoped to a store.
///
#[derive(Debug, Clone)]
pub struct Store {
/// Store type (User or Repo)
pub kind: StoreKind,
/// Absolute path to the store root directory
pub root: PathBuf,
}
pub fn find_decapod_project_root(start_dir: &Path) -> Result<PathBuf, error::DecapodError> {
let mut current_dir = PathBuf::from(start_dir);
loop {
if current_dir.join(".decapod").exists() {
return Ok(current_dir);
}
if !current_dir.pop() {
return Err(error::DecapodError::NotFound(
"'.decapod' directory not found in current or parent directories. Run `decapod init` first.".to_string(),
));
}
}
}
pub fn find_governance_root(workspace_root: &Path) -> PathBuf {
// If we are in a worktree, the governance root is the main repo.
// Otherwise, it's just the workspace root.
workspace::get_main_repo_root(workspace_root).unwrap_or_else(|_| workspace_root.to_path_buf())
}