use std::path::PathBuf;
use chrono::NaiveDate;
use serde::{Deserialize, Serialize};
use crate::{
annotation::SourceLocation,
ids::{CapabilityId, DecisionId, IntentId, PlanId, ProjectId, SpaceId},
owner::Owner,
plan::PlanStatus,
time::EpochMillis,
};
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ConvergenceSpace {
pub id: SpaceId,
pub name: String,
pub root_path: PathBuf,
pub created_at: EpochMillis,
pub updated_at: EpochMillis,
pub members: Vec<ProjectId>,
pub meta: Option<serde_json::Value>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Project {
pub id: ProjectId,
pub space_id: SpaceId,
pub name: String,
pub description: Option<String>,
pub root_path: PathBuf,
pub language: Option<String>,
pub created_at: EpochMillis,
pub updated_at: EpochMillis,
pub meta: Option<serde_json::Value>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Capability {
pub id: CapabilityId,
pub project_id: ProjectId,
pub name: String,
pub description: Option<String>,
pub substrate: Option<String>,
pub consumes: Vec<String>,
pub produces: Vec<String>,
pub status: CapabilityStatus,
pub stub: bool,
pub stub_since: Option<NaiveDate>,
pub owner: Option<Owner>,
pub source: SourceLocation,
pub annotation_raw: String,
pub conditional: bool,
pub created_at: EpochMillis,
pub updated_at: EpochMillis,
pub meta: Option<serde_json::Value>,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum CapabilityStatus {
Proposed,
InFlight,
Landed,
Stale,
Superseded,
Parked,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Intent {
pub id: IntentId,
pub space_id: SpaceId,
pub project_id: Option<ProjectId>,
pub kind: IntentKind,
pub heading: String,
pub description: String,
pub scope_path: PathBuf,
pub scope_depth: u32,
pub substrate: Option<String>,
pub owner: Option<Owner>,
pub source: SourceLocation,
pub source_kind: IntentSourceKind,
pub created_at: EpochMillis,
pub updated_at: EpochMillis,
pub meta: Option<serde_json::Value>,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum IntentKind {
ArchitecturalScope,
Boundary,
Operational,
TechStack,
ExplicitIntent,
Unclassified,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum IntentSourceKind {
AgentsMd,
ClaudeMd,
G8Sidecar,
InlineComment,
Manual,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Decision {
pub id: DecisionId,
pub space_id: SpaceId,
pub title: String,
pub status: DecisionStatus,
pub context: Option<String>,
pub body: String,
pub source_file: Option<PathBuf>,
pub created_at: EpochMillis,
pub updated_at: EpochMillis,
pub meta: Option<serde_json::Value>,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum DecisionStatus {
Proposed,
Accepted,
Rejected,
Superseded,
RuledOut,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Plan {
pub id: PlanId,
pub space_id: SpaceId,
pub project_id: Option<ProjectId>,
pub title: String,
pub description: Option<String>,
pub status: PlanStatus,
pub substrate: Option<String>,
pub touched_capabilities: Vec<CapabilityId>,
pub derived_from_intents: Vec<IntentId>,
pub governed_by_decisions: Vec<DecisionId>,
pub wip_weight: u32,
pub parked_reason: Option<String>,
pub blocked_reason: Option<String>,
pub dispatched_at: Option<EpochMillis>,
pub completed_at: Option<EpochMillis>,
pub created_at: EpochMillis,
pub updated_at: EpochMillis,
pub meta: Option<serde_json::Value>,
}