use std::path::PathBuf; use schemars::JsonSchema; use serde::Deserialize; use serde::Serialize; use ts_rs::TS; mod prompt; pub use prompt::render_epiphany_state; #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS)] pub struct EpiphanyStateItem { #[serde(default, skip_serializing_if = "Option::is_none")] pub turn_id: Option, pub state: EpiphanyThreadState, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyThreadState { pub revision: u64, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub objective: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub active_subgoal_id: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub subgoals: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub invariants: Vec, #[serde(default, skip_serializing_if = "EpiphanyGraphs::is_empty")] #[ts(type = "EpiphanyGraphs")] pub graphs: EpiphanyGraphs, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "EpiphanyGraphFrontier | null")] pub graph_frontier: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "EpiphanyGraphCheckpoint | null")] pub graph_checkpoint: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "EpiphanyRetrievalState | null")] pub retrieval: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "EpiphanyScratchPad | null")] pub scratch: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "EpiphanyInvestigationCheckpoint | null")] pub investigation_checkpoint: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub job_bindings: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub acceptance_receipts: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub runtime_links: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub observations: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub recent_evidence: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "EpiphanyChurnState | null")] pub churn: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "EpiphanyModeState | null")] pub mode: Option, #[serde(default, skip_serializing_if = "EpiphanyPlanningState::is_empty")] #[ts(type = "EpiphanyPlanningState")] pub planning: EpiphanyPlanningState, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub last_updated_turn_id: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyAcceptanceReceipt { pub id: String, pub result_id: String, pub job_id: String, pub binding_id: String, pub surface: String, pub role_id: String, pub status: String, pub accepted_at: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub accepted_observation_id: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub accepted_evidence_id: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub summary: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyRuntimeLink { pub id: String, pub binding_id: String, pub surface: String, pub role_id: String, pub authority_scope: String, pub runtime_job_id: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub runtime_result_id: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] pub linked_subgoal_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] pub linked_graph_node_ids: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanySubgoal { pub id: String, pub title: String, pub status: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub summary: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyInvariant { pub id: String, pub description: String, pub status: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub rationale: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyGraphs { #[serde(default, skip_serializing_if = "EpiphanyGraph::is_empty")] pub architecture: EpiphanyGraph, #[serde(default, skip_serializing_if = "EpiphanyGraph::is_empty")] pub dataflow: EpiphanyGraph, #[serde(default, skip_serializing_if = "Vec::is_empty")] pub links: Vec, } impl EpiphanyGraphs { pub fn is_empty(&self) -> bool { self.architecture.is_empty() && self.dataflow.is_empty() && self.links.is_empty() } } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyGraph { #[serde(default, skip_serializing_if = "Vec::is_empty")] pub nodes: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] pub edges: Vec, } impl EpiphanyGraph { pub fn is_empty(&self) -> bool { self.nodes.is_empty() && self.edges.is_empty() } } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyGraphNode { pub id: String, pub title: String, pub purpose: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub mechanism: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub metaphor: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub status: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub code_refs: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyGraphEdge { pub source_id: String, pub target_id: String, pub kind: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub id: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub label: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub mechanism: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub code_refs: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyGraphLink { pub dataflow_node_id: String, pub architecture_node_id: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub relationship: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub code_refs: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyCodeRef { pub path: PathBuf, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "number | null")] pub start_line: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "number | null")] pub end_line: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub symbol: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub note: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyGraphFrontier { #[serde(default, skip_serializing_if = "Vec::is_empty")] pub active_node_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] pub active_edge_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] pub open_question_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] pub open_gap_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] pub dirty_paths: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyGraphCheckpoint { pub checkpoint_id: String, pub graph_revision: u64, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub summary: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub frontier_node_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub open_question_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub open_gap_ids: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyRetrievalState { pub workspace_root: PathBuf, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub index_revision: Option, #[serde(default)] pub status: EpiphanyRetrievalStatus, #[serde(default, skip_serializing_if = "std::ops::Not::not")] #[ts(type = "boolean")] pub semantic_available: bool, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "bigint | null")] pub last_indexed_at_unix_seconds: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "number | null")] pub indexed_file_count: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "number | null")] pub indexed_chunk_count: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub shards: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub dirty_paths: Vec, } #[derive(Serialize, Deserialize, Clone, Copy, Debug, PartialEq, Eq, JsonSchema, TS, Default)] #[serde(rename_all = "snake_case")] #[ts(rename_all = "snake_case")] pub enum EpiphanyRetrievalStatus { #[default] Unavailable, Ready, Stale, Indexing, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyRetrievalShardSummary { pub shard_id: String, pub path_prefix: PathBuf, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "number | null")] pub indexed_file_count: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "number | null")] pub indexed_chunk_count: Option, #[serde(default)] pub status: EpiphanyRetrievalStatus, #[serde(default, skip_serializing_if = "std::ops::Not::not")] #[ts(type = "boolean")] pub exact_available: bool, #[serde(default, skip_serializing_if = "std::ops::Not::not")] #[ts(type = "boolean")] pub semantic_available: bool, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyScratchPad { #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub summary: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub hypothesis: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub next_probe: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub notes: Vec, } #[derive(Serialize, Deserialize, Clone, Copy, Debug, PartialEq, Eq, JsonSchema, TS, Default)] #[serde(rename_all = "snake_case")] #[ts(rename_all = "snake_case")] pub enum EpiphanyInvestigationDisposition { #[default] ResumeReady, RegatherRequired, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyInvestigationCheckpoint { pub checkpoint_id: String, pub kind: String, pub disposition: EpiphanyInvestigationDisposition, pub focus: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub summary: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub next_action: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub captured_at_turn_id: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub open_questions: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub code_refs: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub evidence_ids: Vec, } #[derive(Serialize, Deserialize, Clone, Copy, Debug, PartialEq, Eq, JsonSchema, TS)] #[serde(rename_all = "snake_case")] #[ts(rename_all = "snake_case")] pub enum EpiphanyJobKind { Indexing, Remap, Verification, Specialist, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS)] pub struct EpiphanyJobBinding { pub id: String, pub kind: EpiphanyJobKind, pub scope: String, pub owner_role: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub authority_scope: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub linked_subgoal_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub linked_graph_node_ids: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub blocking_reason: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyObservation { pub id: String, pub summary: String, pub source_kind: String, pub status: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] pub code_refs: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] pub evidence_ids: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyEvidenceRecord { pub id: String, pub kind: String, pub status: String, pub summary: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] pub code_refs: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyChurnState { pub understanding_status: String, pub diff_pressure: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub graph_freshness: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub warning: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "number | null")] pub unexplained_writes: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyModeState { pub name: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "ModeKind | null")] pub kind: Option, } #[derive( Serialize, Deserialize, Clone, Copy, Debug, PartialEq, Eq, Hash, JsonSchema, TS, Default, )] #[serde(rename_all = "snake_case")] pub enum EpiphanyModeKind { Plan, #[default] #[serde( alias = "code", alias = "pair_programming", alias = "execute", alias = "custom" )] Default, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyPlanningState { #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub workspace_root: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub captures: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub backlog_items: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub roadmap_streams: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub objective_drafts: Vec, } impl EpiphanyPlanningState { pub fn is_empty(&self) -> bool { self.workspace_root.is_none() && self.captures.is_empty() && self.backlog_items.is_empty() && self.roadmap_streams.is_empty() && self.objective_drafts.is_empty() } } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyPlanningCapture { pub id: String, pub title: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub body: Option, pub confidence: String, pub status: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub speaker: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub tags: Vec, pub source: EpiphanyPlanningSourceRef, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub created_at: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub updated_at: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyPlanningSourceRef { pub kind: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub provider: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub uri: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub external_id: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub repo: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "number | null")] pub issue_number: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub node_id: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "bigint | null")] pub database_id: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub url: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub state: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub labels: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub milestone: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub assignees: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub author: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub created_at: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub updated_at: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub closed_at: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "boolean | null")] pub is_pull_request: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub imported_at: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyBacklogItem { pub id: String, pub title: String, pub kind: String, pub summary: String, pub status: String, pub horizon: String, pub priority: EpiphanyPlanningPriority, pub confidence: String, pub product_area: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub lane_hints: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub dependencies: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub blockers: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub acceptance_sketch: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub evidence_refs: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub source_refs: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub duplicate_of: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub updated_at: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyPlanningPriority { pub value: String, pub rationale: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub impact: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub urgency: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub confidence: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub effort: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub unblocks: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub blocks: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub reason: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyRoadmapStream { pub id: String, pub title: String, pub purpose: String, pub status: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub item_ids: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub near_term_focus: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub blocked_by: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub review_cadence: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyObjectiveDraft { pub id: String, pub title: String, pub summary: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub source_item_ids: Vec, pub scope: EpiphanyObjectiveDraftScope, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub acceptance_criteria: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub evidence_required: Vec, pub lane_plan: EpiphanyObjectiveDraftLanePlan, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub dependencies: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub risks: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub review_gates: Vec, pub status: String, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyObjectiveDraftScope { #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub includes: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub excludes: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyObjectiveDraftLanePlan { #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub imagination: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub eyes: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub body: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub hands: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub soul: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub life: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemoryGraphSnapshot { #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub schema_version: Option, pub graph_id: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub domains: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub nodes: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub edges: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub summaries: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "EpiphanyMemoryEmbeddingManifest | null")] pub embedding_manifest: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "EpiphanyMemoryFreshness | null")] pub freshness: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub lifecycle_receipts: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemoryDomain { pub id: String, pub profile: EpiphanyMemoryProfile, pub title: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub description: Option, #[serde(default)] pub lifecycle: EpiphanyMemoryLifecycle, } #[derive( Serialize, Deserialize, Clone, Copy, Debug, PartialEq, Eq, Hash, JsonSchema, TS, Default, )] #[serde(rename_all = "snake_case")] #[ts(rename_all = "snake_case")] pub enum EpiphanyMemoryProfile { #[default] RepoArchitecture, RepoDataflow, RoleSelf, ShortTerm, Incubation, AgencyPressure, CandidateIntervention, Identity, Evidence, } #[derive( Serialize, Deserialize, Clone, Copy, Debug, PartialEq, Eq, Hash, JsonSchema, TS, Default, )] #[serde(rename_all = "snake_case")] #[ts(rename_all = "snake_case")] pub enum EpiphanyMemoryLifecycle { #[default] Observed, Proposed, Accepted, Active, Clustered, Distilled, Incubated, Pruned, Revised, Retired, Crystallized, Stale, Deepening, Cooling, Promoted, Queued, Deferred, Spoken, Applied, Obligated, Answered, Reviewed, Contradicted, Superseded, } #[derive( Serialize, Deserialize, Clone, Copy, Debug, PartialEq, Eq, Hash, JsonSchema, TS, Default, )] #[serde(rename_all = "snake_case")] #[ts(rename_all = "snake_case")] pub enum EpiphanyMemoryNodeKind { #[default] Domain, Module, Crate, Binary, Schema, RuntimeContract, Adapter, TestSeam, StateStore, RoleMemory, ShortTermThought, IncubationThread, AgencyPressure, CandidateIntervention, Identity, Evidence, Summary, Other, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemoryNode { pub id: String, pub domain_id: String, pub profile: EpiphanyMemoryProfile, pub kind: EpiphanyMemoryNodeKind, pub title: String, pub claim: String, pub question: String, pub tension: String, pub action_implication: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub anchors: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub source_hashes: Vec, #[serde(default)] pub lifecycle: EpiphanyMemoryLifecycle, #[serde(default, skip_serializing_if = "is_zero_u32")] pub salience: u32, #[serde(default, skip_serializing_if = "is_zero_u32")] pub confidence: u32, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub created_at: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub updated_at: Option, } #[derive( Serialize, Deserialize, Clone, Copy, Debug, PartialEq, Eq, Hash, JsonSchema, TS, Default, )] #[serde(rename_all = "snake_case")] #[ts(rename_all = "snake_case")] pub enum EpiphanyMemoryEdgeKind { #[default] Owns, Reads, Writes, Derives, Adapts, Persists, Launches, Verifies, Supports, Contradicts, Distills, Revises, Retires, Grounds, Triggers, SpokenAs, Cools, ClustersWith, ResonatesWith, DependsOn, Other, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemoryEdge { pub id: String, pub source_id: String, pub target_id: String, pub kind: EpiphanyMemoryEdgeKind, pub profile: EpiphanyMemoryProfile, pub claim: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub anchors: Vec, #[serde(default)] pub lifecycle: EpiphanyMemoryLifecycle, #[serde(default, skip_serializing_if = "is_zero_u32")] pub confidence: u32, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemoryAnchor { pub id: String, pub kind: String, pub target: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "EpiphanyCodeRef | null")] pub code_ref: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub evidence_id: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub source_hash: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub note: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemorySummary { pub id: String, pub domain_id: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub covers_node_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub covers_edge_ids: Vec, pub target: String, pub claim: String, pub question: String, pub tension: String, pub action_implication: String, #[serde(default, skip_serializing_if = "is_zero_u32")] pub anchor_count: u32, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub source_hashes: Vec, #[serde(default)] pub freshness: EpiphanyMemoryFreshnessStatus, #[serde(default, skip_serializing_if = "is_zero_u32")] pub confidence: u32, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub known_omissions: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemoryLifecycleReceipt { pub id: String, pub operation: String, pub status: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub node_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub edge_ids: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub reason: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub created_at: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemoryEmbeddingManifest { pub id: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub collection_name: Option, pub embedding_model: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "number | null")] pub vector_dimensions: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub indexed_document_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub stale_document_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub source_hashes: Vec, } #[derive( Serialize, Deserialize, Clone, Copy, Debug, PartialEq, Eq, Hash, JsonSchema, TS, Default, )] #[serde(rename_all = "snake_case")] #[ts(rename_all = "snake_case")] pub enum EpiphanyMemoryFreshnessStatus { #[default] Missing, Ready, Stale, Indexing, Unavailable, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemoryFreshness { pub status: EpiphanyMemoryFreshnessStatus, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub stale_node_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub stale_edge_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub stale_summary_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub dirty_source_hashes: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub note: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemoryContextQuery { pub id: String, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "EpiphanyMemoryProfile | null")] pub profile: Option, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub domain_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub node_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub edge_ids: Vec, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "string | null")] pub text: Option, #[serde(default, skip_serializing_if = "Option::is_none")] #[ts(type = "number | null")] pub budget: Option, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemoryContextPacket { pub id: String, pub query_id: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub nodes: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub edges: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub summaries: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub anchors: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub warnings: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub missing_node_ids: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub missing_edge_ids: Vec, } #[derive(Serialize, Deserialize, Clone, Debug, PartialEq, Eq, JsonSchema, TS, Default)] pub struct EpiphanyMemoryPatchCandidate { pub id: String, pub profile: EpiphanyMemoryProfile, pub status: String, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub proposed_nodes: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub proposed_edges: Vec, #[serde(default, skip_serializing_if = "Vec::is_empty")] #[ts(type = "Array")] pub reasons: Vec, } fn is_zero_u32(value: &u32) -> bool { *value == 0 }