This repository has been archived on 2026-10-29. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
Epiphany/epiphany-codex-bridge/src/launch_context.rs
2026-06-02 14:19:43 +01:00

228 lines
8.6 KiB
Rust

use chrono::SecondsFormat;
use chrono::Utc;
use epiphany_core::EpiphanyMemoryContextPacket;
use epiphany_core::EpiphanyMemoryContextQuery;
use epiphany_core::EpiphanyMemoryProfile;
use epiphany_core::EpiphanyPromptContextInput;
use epiphany_core::EpiphanyThreadState;
use epiphany_core::load_memory_graph_snapshot;
use epiphany_core::memory_graph_from_epiphany_graphs;
use epiphany_core::plan_memory_graph_context_cut;
use epiphany_core::query_epiphany_local_verse_context;
use epiphany_core::render_epiphany_prompt_context;
use epiphany_core::seed_epiphany_local_verse_context;
use epiphany_core::write_memory_graph_snapshot;
use std::path::Path;
use std::path::PathBuf;
pub const EPIPHANY_LOCAL_VERSE_RUNTIME_ID: &str = "epiphany-local";
pub fn local_verse_store_path(runtime_store_path: &Path) -> PathBuf {
sibling_state_store_path(runtime_store_path, "local-verse.ccmp")
}
pub fn memory_graph_store_path(runtime_store_path: &Path) -> PathBuf {
sibling_state_store_path(runtime_store_path, "memory-graph.msgpack")
}
fn sibling_state_store_path(runtime_store_path: &Path, filename: &str) -> PathBuf {
runtime_store_path
.parent()
.unwrap_or_else(|| Path::new("."))
.join(filename)
}
pub fn role_launch_context_focus(state: &EpiphanyThreadState, role_label: &str) -> String {
let objective = state
.objective
.as_deref()
.map(str::trim)
.filter(|objective| !objective.is_empty())
.unwrap_or("Epiphany worker launch");
format!("Launch `{role_label}` worker for: {objective}")
}
pub fn reorient_launch_context_focus(state: &EpiphanyThreadState, next_action: &str) -> String {
let objective = state
.objective
.as_deref()
.map(str::trim)
.filter(|objective| !objective.is_empty())
.unwrap_or("Epiphany reorientation");
format!("Launch reorientation worker for: {objective}. Next action: {next_action}")
}
pub fn render_launch_dynamic_prompt_context(
runtime_store_path: &Path,
state: &EpiphanyThreadState,
focus: String,
) -> Result<String, String> {
let local_verse_store = local_verse_store_path(runtime_store_path);
seed_epiphany_local_verse_context(
&local_verse_store,
EPIPHANY_LOCAL_VERSE_RUNTIME_ID,
Utc::now().to_rfc3339_opts(SecondsFormat::Secs, true),
)
.map_err(|error| {
format!(
"failed to seed local Verse context store {}: {error}",
local_verse_store.display()
)
})?;
let local_verse =
query_epiphany_local_verse_context(&local_verse_store, EPIPHANY_LOCAL_VERSE_RUNTIME_ID)
.map_err(|error| {
format!(
"failed to query local Verse context store {}: {error}",
local_verse_store.display()
)
})?;
let memory_context =
launch_memory_context(runtime_store_path, state, focus.as_str()).map_err(|error| {
format!(
"failed to build launch memory context beside {}: {error}",
runtime_store_path.display()
)
})?;
Ok(render_epiphany_prompt_context(
&EpiphanyPromptContextInput {
focus,
local_verse,
memory_context,
},
))
}
fn launch_memory_context(
runtime_store_path: &Path,
state: &EpiphanyThreadState,
focus: &str,
) -> Result<EpiphanyMemoryContextPacket, String> {
let memory_graph_store = memory_graph_store_path(runtime_store_path);
let (snapshot, refreshed_from_state) = match load_memory_graph_snapshot(&memory_graph_store)
.map_err(|error| {
format!(
"failed to load memory graph store {}: {error}",
memory_graph_store.display()
)
})? {
Some(snapshot) => (snapshot, false),
None => {
let snapshot = memory_graph_from_epiphany_graphs(
format!("bridge-launch-state-rev-{}", state.revision),
&state.graphs,
);
write_memory_graph_snapshot(&memory_graph_store, &snapshot).map_err(|error| {
format!(
"failed to write memory graph store {} from thread state: {error}",
memory_graph_store.display()
)
})?;
(snapshot, true)
}
};
let mut packet = plan_memory_graph_context_cut(
&snapshot,
&EpiphanyMemoryContextQuery {
id: format!("bridge-launch-query-state-rev-{}", state.revision),
profile: Some(EpiphanyMemoryProfile::RepoArchitecture),
text: Some(focus.to_string()),
budget: Some(5),
..Default::default()
},
);
if refreshed_from_state {
packet.warnings.push(format!(
"Memory graph store was refreshed from current thread-state repo graph at {}.",
memory_graph_store.display()
));
}
if packet.nodes.is_empty() && packet.summaries.is_empty() {
packet.warnings.push(
"Memory graph context is empty for this launch focus; the accepted repo graph may be thin or stale.".to_string(),
);
}
Ok(packet)
}
#[cfg(test)]
mod tests {
use super::*;
use epiphany_core::EpiphanyRoleResultRoleId;
use epiphany_core::RuntimeSpineHeartbeatJobOptions;
use epiphany_core::build_epiphany_role_launch_request_with_dynamic_context;
use epiphany_core::open_runtime_spine_heartbeat_job;
use epiphany_core::runtime_worker_launch_request;
use std::fs;
use uuid::Uuid;
#[test]
fn launch_context_persists_on_runtime_worker_request() -> anyhow::Result<()> {
let temp =
std::env::temp_dir().join(format!("epiphany-bridge-launch-context-{}", Uuid::new_v4()));
fs::create_dir_all(&temp)?;
let runtime_store = temp.join("runtime-spine.msgpack");
let state = EpiphanyThreadState {
revision: 7,
objective: Some("Test launch context.".to_string()),
..Default::default()
};
let rendered = render_launch_dynamic_prompt_context(
&runtime_store,
&state,
role_launch_context_focus(&state, "modeling"),
)
.map_err(anyhow::Error::msg)?;
assert!(rendered.contains("<epiphany_dynamic_context>"));
assert!(rendered.contains("Test launch context."));
assert!(rendered.contains("Odin"));
assert!(rendered.contains("Yggdrasil"));
assert!(rendered.contains("Memory graph"));
assert!(local_verse_store_path(&runtime_store).exists());
assert!(memory_graph_store_path(&runtime_store).exists());
let launch_request = build_epiphany_role_launch_request_with_dynamic_context(
"thread-1",
EpiphanyRoleResultRoleId::Modeling,
Some(state.revision),
Some(60),
&state,
Some(rendered.clone()),
)
.map_err(anyhow::Error::msg)?;
open_runtime_spine_heartbeat_job(
&runtime_store,
RuntimeSpineHeartbeatJobOptions {
runtime_id: EPIPHANY_LOCAL_VERSE_RUNTIME_ID.to_string(),
display_name: "Epiphany Local".to_string(),
session_id: "epiphany-main".to_string(),
objective: "Test persisted launch context.".to_string(),
coordinator_note: "Bridge launch-context smoke.".to_string(),
job_id: "job-launch-context".to_string(),
role: launch_request.owner_role.clone(),
binding_id: launch_request.binding_id.clone(),
authority_scope: launch_request.authority_scope.clone(),
instruction: launch_request.instruction.clone(),
launch_document: launch_request.launch_document.clone(),
output_contract_id: launch_request.output_contract_id.clone(),
organ_launch_contract: launch_request.organ_launch_contract.clone(),
created_at: "2026-06-02T00:00:00Z".to_string(),
},
)?;
let stored = runtime_worker_launch_request(&runtime_store, "job-launch-context")?
.expect("runtime worker launch request should be persisted");
let stored_document = stored.launch_document()?;
let stored_context = stored_document
.dynamic_prompt_context()
.expect("stored launch document should carry dynamic context");
assert!(stored_context.contains("Odin"));
assert!(stored_context.contains("Memory graph"));
assert!(stored_context.contains("Test launch context."));
fs::remove_dir_all(&temp)?;
Ok(())
}
}