Add Idunn daemon survival rehearsal
This commit is contained in:
parent
d01f45740d
commit
58d8f453e1
6 changed files with 404 additions and 14 deletions
|
|
@ -0,0 +1,334 @@
|
|||
use anyhow::Context;
|
||||
use anyhow::Result;
|
||||
use anyhow::anyhow;
|
||||
use chrono::Utc;
|
||||
use serde_json::Value;
|
||||
use serde_json::json;
|
||||
use std::env;
|
||||
use std::fs;
|
||||
use std::path::Path;
|
||||
use std::path::PathBuf;
|
||||
use std::process::Command;
|
||||
|
||||
fn main() -> Result<()> {
|
||||
let args = Args::parse()?;
|
||||
let result = run_smoke(args)?;
|
||||
println!("{}", serde_json::to_string_pretty(&result)?);
|
||||
Ok(())
|
||||
}
|
||||
|
||||
#[derive(Clone, Debug)]
|
||||
struct Args {
|
||||
root: PathBuf,
|
||||
smoke_root: PathBuf,
|
||||
}
|
||||
|
||||
impl Args {
|
||||
fn parse() -> Result<Self> {
|
||||
let mut root = env::current_dir().context("failed to resolve current directory")?;
|
||||
let mut smoke_root = root.join(".epiphany-smoke");
|
||||
let mut args = env::args().skip(1).peekable();
|
||||
while let Some(arg) = args.next() {
|
||||
match arg.as_str() {
|
||||
"--root" => root = take_path(&mut args, "--root")?,
|
||||
"--smoke-root" => smoke_root = take_path(&mut args, "--smoke-root")?,
|
||||
other => return Err(anyhow!("unexpected argument {other:?}")),
|
||||
}
|
||||
}
|
||||
Ok(Self { root, smoke_root })
|
||||
}
|
||||
}
|
||||
|
||||
fn run_smoke(args: Args) -> Result<Value> {
|
||||
let root = args
|
||||
.root
|
||||
.canonicalize()
|
||||
.with_context(|| format!("failed to resolve {}", args.root.display()))?;
|
||||
let manifest = root.join("epiphany-core").join("Cargo.toml");
|
||||
if !manifest.exists() {
|
||||
return Err(anyhow!(
|
||||
"could not find epiphany-core manifest at {}",
|
||||
manifest.display()
|
||||
));
|
||||
}
|
||||
fs::create_dir_all(&args.smoke_root)
|
||||
.with_context(|| format!("failed to create {}", args.smoke_root.display()))?;
|
||||
let stamp = Utc::now().format("%Y%m%d-%H%M%S").to_string();
|
||||
let smoke_dir = args
|
||||
.smoke_root
|
||||
.join(format!("daemon-survival-rehearsal-{stamp}"));
|
||||
if smoke_dir.exists() {
|
||||
fs::remove_dir_all(&smoke_dir)
|
||||
.with_context(|| format!("failed to clear {}", smoke_dir.display()))?;
|
||||
}
|
||||
fs::create_dir_all(&smoke_dir)
|
||||
.with_context(|| format!("failed to create {}", smoke_dir.display()))?;
|
||||
|
||||
let local_verse = smoke_dir.join("local-verse.ccmp");
|
||||
let runtime_id = "epiphany-local";
|
||||
let daemon_id = "epiphany-daemon-self";
|
||||
let scheduler_id = "epiphany-daemon-survival-rehearsal";
|
||||
let restart_command = if cfg!(windows) {
|
||||
"powershell.exe"
|
||||
} else {
|
||||
"sh"
|
||||
};
|
||||
let restart_args = if cfg!(windows) {
|
||||
vec!["-NoProfile", "-Command", "exit 0"]
|
||||
} else {
|
||||
vec!["-c", "exit 0"]
|
||||
};
|
||||
|
||||
let mut policy_args = vec![
|
||||
"policy",
|
||||
"--store",
|
||||
path_str(&local_verse)?,
|
||||
"--runtime-id",
|
||||
runtime_id,
|
||||
"--daemon-id",
|
||||
daemon_id,
|
||||
"--scheduler-id",
|
||||
scheduler_id,
|
||||
"--restart-command",
|
||||
restart_command,
|
||||
"--cwd",
|
||||
path_str(&root)?,
|
||||
"--cooldown-seconds",
|
||||
"0",
|
||||
"--reconcile-interval-seconds",
|
||||
"0",
|
||||
"--heartbeat-stale-seconds",
|
||||
"3600",
|
||||
]
|
||||
.into_iter()
|
||||
.map(str::to_string)
|
||||
.collect::<Vec<_>>();
|
||||
for arg in &restart_args {
|
||||
policy_args.push("--restart-arg".to_string());
|
||||
policy_args.push((*arg).to_string());
|
||||
}
|
||||
let policy = cargo_json(
|
||||
&manifest,
|
||||
"epiphany-daemon-supervisor",
|
||||
&string_refs(&policy_args),
|
||||
&root,
|
||||
)?;
|
||||
|
||||
let serve_args = vec![
|
||||
"serve",
|
||||
"--store",
|
||||
path_str(&local_verse)?,
|
||||
"--runtime-id",
|
||||
runtime_id,
|
||||
"--daemon-id",
|
||||
daemon_id,
|
||||
"--scheduler-id",
|
||||
scheduler_id,
|
||||
"--loop-interval-seconds",
|
||||
"0",
|
||||
"--max-iterations",
|
||||
"2",
|
||||
"--force",
|
||||
]
|
||||
.into_iter()
|
||||
.map(str::to_string)
|
||||
.collect::<Vec<_>>();
|
||||
let serve = cargo_json(
|
||||
&manifest,
|
||||
"epiphany-daemon-supervisor",
|
||||
&string_refs(&serve_args),
|
||||
&root,
|
||||
)?;
|
||||
|
||||
require_eq(&policy, &["status"], "written")?;
|
||||
require_eq(&policy, &["daemonId"], daemon_id)?;
|
||||
require_bool(&policy, &["privateStateExposed"], false)?;
|
||||
require_eq(&serve, &["status"], "serveComplete")?;
|
||||
require_u64(&serve, &["iterations"], 2)?;
|
||||
require_bool(&serve, &["privateStateExposed"], false)?;
|
||||
let outputs = serve
|
||||
.get("outputs")
|
||||
.and_then(Value::as_array)
|
||||
.ok_or_else(|| anyhow!("serve output missing outputs array"))?;
|
||||
if outputs.len() != 2 {
|
||||
return Err(anyhow!("expected 2 serve outputs, got {}", outputs.len()));
|
||||
}
|
||||
for (idx, output) in outputs.iter().enumerate() {
|
||||
require_eq(output, &["status"], "tickComplete")?;
|
||||
require_eq(output, &["schedulerId"], scheduler_id)?;
|
||||
require_u64(output, &["iteration"], (idx + 1) as u64)?;
|
||||
require_u64(output, &["outcomeCount"], 1)?;
|
||||
require_u64(output, &["restartedCount"], 1)?;
|
||||
require_u64(output, &["refusedCount"], 0)?;
|
||||
require_bool(output, &["privateStateExposed"], false)?;
|
||||
let outcomes = output
|
||||
.get("outcomes")
|
||||
.and_then(Value::as_array)
|
||||
.ok_or_else(|| anyhow!("tick output missing outcomes array"))?;
|
||||
let outcome = outcomes
|
||||
.first()
|
||||
.ok_or_else(|| anyhow!("tick output missing first outcome"))?;
|
||||
require_eq(outcome, &["status"], "restarted")?;
|
||||
require_eq(outcome, &["daemonId"], daemon_id)?;
|
||||
require_bool(outcome, &["privateStateExposed"], false)?;
|
||||
}
|
||||
|
||||
let receipt_directory = cargo_json(
|
||||
&manifest,
|
||||
"epiphany-verse-query",
|
||||
&[
|
||||
"receipt-directory",
|
||||
"--store",
|
||||
path_str(&local_verse)?,
|
||||
"--runtime-id",
|
||||
runtime_id,
|
||||
],
|
||||
&root,
|
||||
)?;
|
||||
require_bool(&receipt_directory, &["privateStateExposed"], false)?;
|
||||
let scheduler_row = rows(&receipt_directory)
|
||||
.iter()
|
||||
.find(|row| row.get("family").and_then(Value::as_str) == Some("scheduler"))
|
||||
.cloned()
|
||||
.ok_or_else(|| anyhow!("receipt directory did not expose scheduler row"))?;
|
||||
require_eq(&scheduler_row, &["status"], "tickComplete")?;
|
||||
require_eq(&scheduler_row, &["route"], daemon_id)?;
|
||||
require_bool(&scheduler_row, &["privateStateExposed"], false)?;
|
||||
|
||||
let summary = json!({
|
||||
"schemaVersion": "epiphany.daemon_survival_rehearsal_smoke.v0",
|
||||
"status": "ok",
|
||||
"smokeDir": smoke_dir,
|
||||
"localVerseStore": local_verse,
|
||||
"runtimeId": runtime_id,
|
||||
"daemonId": daemon_id,
|
||||
"schedulerId": scheduler_id,
|
||||
"policyStatus": policy["status"],
|
||||
"policyId": policy["policyId"],
|
||||
"serveStatus": serve["status"],
|
||||
"serveIterations": serve["iterations"],
|
||||
"schedulerReceiptId": scheduler_row["latestId"],
|
||||
"schedulerReceiptStatus": scheduler_row["status"],
|
||||
"restartCommand": restart_command,
|
||||
"restartArgs": restart_args,
|
||||
"boundedProofMode": true,
|
||||
"serviceManagerMutated": false,
|
||||
"requiresElevatedAuthority": false,
|
||||
"unattendedDaemonSurvivalRehearsed": true,
|
||||
"privateStateExposed": false,
|
||||
});
|
||||
write_json(&smoke_dir.join("summary.json"), &summary)?;
|
||||
Ok(summary)
|
||||
}
|
||||
|
||||
fn cargo_json(manifest: &Path, bin: &str, args: &[&str], cwd: &Path) -> Result<Value> {
|
||||
let output = Command::new("cargo")
|
||||
.arg("run")
|
||||
.arg("--quiet")
|
||||
.arg("--manifest-path")
|
||||
.arg(manifest)
|
||||
.arg("--bin")
|
||||
.arg(bin)
|
||||
.arg("--")
|
||||
.args(args)
|
||||
.current_dir(cwd)
|
||||
.output()
|
||||
.with_context(|| format!("failed to run cargo bin {bin}"))?;
|
||||
if !output.status.success() {
|
||||
return Err(anyhow!(
|
||||
"{bin} failed with status {:?}\nstdout:\n{}\nstderr:\n{}",
|
||||
output.status.code(),
|
||||
String::from_utf8_lossy(&output.stdout),
|
||||
String::from_utf8_lossy(&output.stderr)
|
||||
));
|
||||
}
|
||||
serde_json::from_slice(&output.stdout).with_context(|| {
|
||||
format!(
|
||||
"{bin} did not emit JSON on stdout:\n{}",
|
||||
String::from_utf8_lossy(&output.stdout)
|
||||
)
|
||||
})
|
||||
}
|
||||
|
||||
fn string_refs(args: &[String]) -> Vec<&str> {
|
||||
args.iter().map(String::as_str).collect()
|
||||
}
|
||||
|
||||
fn rows(value: &Value) -> Vec<&Value> {
|
||||
value
|
||||
.get("rows")
|
||||
.and_then(Value::as_array)
|
||||
.map(|rows| rows.iter().collect())
|
||||
.unwrap_or_default()
|
||||
}
|
||||
|
||||
fn write_json(path: &Path, value: &Value) -> Result<()> {
|
||||
if let Some(parent) = path.parent() {
|
||||
fs::create_dir_all(parent)
|
||||
.with_context(|| format!("failed to create {}", parent.display()))?;
|
||||
}
|
||||
fs::write(path, serde_json::to_vec_pretty(value)?)
|
||||
.with_context(|| format!("failed to write {}", path.display()))
|
||||
}
|
||||
|
||||
fn require_eq(value: &Value, path: &[&str], expected: &str) -> Result<()> {
|
||||
let actual = path
|
||||
.iter()
|
||||
.try_fold(value, |current, key| current.get(*key))
|
||||
.and_then(Value::as_str)
|
||||
.unwrap_or("<missing>");
|
||||
if actual == expected {
|
||||
Ok(())
|
||||
} else {
|
||||
Err(anyhow!(
|
||||
"expected {} to be {expected:?}, got {actual:?}",
|
||||
path.join(".")
|
||||
))
|
||||
}
|
||||
}
|
||||
|
||||
fn require_bool(value: &Value, path: &[&str], expected: bool) -> Result<()> {
|
||||
let actual = path
|
||||
.iter()
|
||||
.try_fold(value, |current, key| current.get(*key))
|
||||
.and_then(Value::as_bool);
|
||||
if actual == Some(expected) {
|
||||
Ok(())
|
||||
} else {
|
||||
Err(anyhow!(
|
||||
"expected {} to be {expected}, got {:?}",
|
||||
path.join("."),
|
||||
actual
|
||||
))
|
||||
}
|
||||
}
|
||||
|
||||
fn require_u64(value: &Value, path: &[&str], expected: u64) -> Result<()> {
|
||||
let actual = path
|
||||
.iter()
|
||||
.try_fold(value, |current, key| current.get(*key))
|
||||
.and_then(Value::as_u64);
|
||||
if actual == Some(expected) {
|
||||
Ok(())
|
||||
} else {
|
||||
Err(anyhow!(
|
||||
"expected {} to be {expected}, got {:?}",
|
||||
path.join("."),
|
||||
actual
|
||||
))
|
||||
}
|
||||
}
|
||||
|
||||
fn take_path(
|
||||
args: &mut std::iter::Peekable<impl Iterator<Item = String>>,
|
||||
flag: &str,
|
||||
) -> Result<PathBuf> {
|
||||
args.next()
|
||||
.map(PathBuf::from)
|
||||
.with_context(|| format!("missing value for {flag}"))
|
||||
}
|
||||
|
||||
fn path_str(path: &Path) -> Result<&str> {
|
||||
path.to_str()
|
||||
.ok_or_else(|| anyhow!("path is not valid UTF-8: {}", path.display()))
|
||||
}
|
||||
|
|
@ -23,6 +23,7 @@ struct Args {
|
|||
fresh_repo_summary: Option<PathBuf>,
|
||||
readiness_summary: Option<PathBuf>,
|
||||
bifrost_accounting_summary: Option<PathBuf>,
|
||||
daemon_survival_summary: Option<PathBuf>,
|
||||
}
|
||||
|
||||
impl Args {
|
||||
|
|
@ -32,6 +33,7 @@ impl Args {
|
|||
let mut fresh_repo_summary = None;
|
||||
let mut readiness_summary = None;
|
||||
let mut bifrost_accounting_summary = None;
|
||||
let mut daemon_survival_summary = None;
|
||||
let mut args = env::args().skip(1).peekable();
|
||||
while let Some(arg) = args.next() {
|
||||
match arg.as_str() {
|
||||
|
|
@ -47,6 +49,10 @@ impl Args {
|
|||
bifrost_accounting_summary =
|
||||
Some(take_path(&mut args, "--bifrost-accounting-summary")?)
|
||||
}
|
||||
"--daemon-survival-summary" => {
|
||||
daemon_survival_summary =
|
||||
Some(take_path(&mut args, "--daemon-survival-summary")?)
|
||||
}
|
||||
other => return Err(anyhow!("unexpected argument {other:?}")),
|
||||
}
|
||||
}
|
||||
|
|
@ -56,6 +62,7 @@ impl Args {
|
|||
fresh_repo_summary,
|
||||
readiness_summary,
|
||||
bifrost_accounting_summary,
|
||||
daemon_survival_summary,
|
||||
})
|
||||
}
|
||||
}
|
||||
|
|
@ -92,14 +99,19 @@ fn run_smoke(args: Args) -> Result<Value> {
|
|||
let bifrost_accounting_summary = args
|
||||
.bifrost_accounting_summary
|
||||
.unwrap_or_else(|| latest_summary(&args.smoke_root, "repo-bifrost-accounting-bundle-"));
|
||||
let daemon_survival_summary = args
|
||||
.daemon_survival_summary
|
||||
.unwrap_or_else(|| latest_summary(&args.smoke_root, "daemon-survival-rehearsal-"));
|
||||
|
||||
let fresh = read_json(&fresh_repo_summary)?;
|
||||
let readiness = read_json(&readiness_summary)?;
|
||||
let bifrost = read_json(&bifrost_accounting_summary)?;
|
||||
let daemon_survival = read_json(&daemon_survival_summary)?;
|
||||
|
||||
verify_fresh_repo(&fresh)?;
|
||||
verify_readiness(&readiness)?;
|
||||
verify_bifrost_accounting(&bifrost)?;
|
||||
verify_daemon_survival(&daemon_survival)?;
|
||||
|
||||
let gate_rows = vec![
|
||||
green(
|
||||
|
|
@ -149,16 +161,16 @@ fn run_smoke(args: Args) -> Result<Value> {
|
|||
"Bifrost",
|
||||
"readiness, artifact acceptance, and metrics accounting rows are closed",
|
||||
),
|
||||
green(
|
||||
"long-running-daemon-proof",
|
||||
"Idunn",
|
||||
"bounded serve rehearsal wrote two scheduler pulses and sealed scheduler receipt",
|
||||
),
|
||||
warning(
|
||||
"idunn-elevated-service",
|
||||
"Idunn",
|
||||
"service install/start/remote deployment execution remains explicit operator authority",
|
||||
),
|
||||
warning(
|
||||
"long-running-daemon-proof",
|
||||
"Idunn",
|
||||
"unattended daemon survival is planned and audited but not yet a green MVP gate",
|
||||
),
|
||||
];
|
||||
let green_gate_count = gate_rows
|
||||
.iter()
|
||||
|
|
@ -192,9 +204,11 @@ fn run_smoke(args: Args) -> Result<Value> {
|
|||
"freshRepoSummary": fresh_repo_summary,
|
||||
"readinessSummary": readiness_summary,
|
||||
"bifrostAccountingSummary": bifrost_accounting_summary,
|
||||
"daemonSurvivalSummary": daemon_survival_summary,
|
||||
"freshRepoSmokeDir": fresh["smokeDir"],
|
||||
"readinessSmokeDir": readiness["smokeDir"],
|
||||
"bifrostAccountingSmokeDir": bifrost["smokeDir"],
|
||||
"daemonSurvivalSmokeDir": daemon_survival["smokeDir"],
|
||||
"mvpReady": false,
|
||||
"demoReady": true,
|
||||
"greenGateCount": green_gate_count,
|
||||
|
|
@ -203,8 +217,7 @@ fn run_smoke(args: Args) -> Result<Value> {
|
|||
"gateRows": gate_rows,
|
||||
"gateTuiRows": gate_tui_rows,
|
||||
"knownRemainingAuthorityGates": [
|
||||
"Idunn elevated service install/start/remote deployment execution",
|
||||
"unattended long-running daemon survival proof"
|
||||
"Idunn elevated service install/start/remote deployment execution"
|
||||
],
|
||||
"privateStateExposed": false,
|
||||
});
|
||||
|
|
@ -302,6 +315,23 @@ fn verify_bifrost_accounting(value: &Value) -> Result<()> {
|
|||
)
|
||||
}
|
||||
|
||||
fn verify_daemon_survival(value: &Value) -> Result<()> {
|
||||
require_eq(
|
||||
value,
|
||||
&["schemaVersion"],
|
||||
"epiphany.daemon_survival_rehearsal_smoke.v0",
|
||||
)?;
|
||||
require_eq(value, &["status"], "ok")?;
|
||||
require_eq(value, &["policyStatus"], "written")?;
|
||||
require_eq(value, &["serveStatus"], "serveComplete")?;
|
||||
require_eq(value, &["schedulerReceiptStatus"], "tickComplete")?;
|
||||
require_bool(value, &["boundedProofMode"], true)?;
|
||||
require_bool(value, &["serviceManagerMutated"], false)?;
|
||||
require_bool(value, &["requiresElevatedAuthority"], false)?;
|
||||
require_bool(value, &["unattendedDaemonSurvivalRehearsed"], true)?;
|
||||
require_bool(value, &["privateStateExposed"], false)
|
||||
}
|
||||
|
||||
fn green(gate: &str, owner: &str, evidence: &str) -> Value {
|
||||
json!({
|
||||
"gate": gate,
|
||||
|
|
|
|||
|
|
@ -193,7 +193,8 @@ remembers doctrine; the branch remembers the blade.
|
|||
- `collaboration-feedback` is the compact public-feedback actuator; use it after or instead of manual `eve-connect` when Persona/human discussion should be routed to Imagination consensus discovery as typed local Verse receipts. Its JSON now points the next agent at Eve and Bifrost follow-on rites.
|
||||
- `bifrost-publication` is the compact non-mutating Bifrost publication proof; use it to prove body-change routing, credit, and GitHub publication receipt state without performing GitHub mutation. Its JSON now points back to compact swarm overview and tool-directory readback.
|
||||
- `bifrost-artifact-acceptance` and `bifrost-metrics` are compact Bifrost/Maintainer closure rites for the safe-family planning/accounting lanes. They write typed accepted-artifact and metrics receipts from explicit artifact/public-proof/review/model-spend/review-load/credit refs, verify latest receipt readback, and let `bifrost-ledger` close `artifact-acceptance-request` and `metrics-request` rows from Bifrost-owned receipts instead of request cargo. The request-family smokes now prove both states: `.epiphany-smoke\repo-artifact-acceptance-request-family-20260621-130520` and `.epiphany-smoke\repo-metrics-request-family-20260621-130635` first assert open request rows, then write final receipts and assert closed rows; wrapper proof `local-20260621-140740-750-2815f6f7` read the closed metrics row with `privateStateExposed=False`. `epiphany-repo-bifrost-accounting-bundle-smoke` consumes the closed family summaries and emits one operator-safe aggregate receipt; wrapper mode `tools/epiphany_local_run.ps1 -Mode bifrost-accounting-bundle` now builds/runs that verifier, accepts optional exact summary paths, writes normal operator run receipts, and proved bundle `.epiphany-smoke\repo-bifrost-accounting-bundle-20260621-132815` via wrapper artifact `local-20260621-142716-268-d6bc58b4` with final Bifrost receipt ids, `planningAuthorityOnly=true`, and `privateStateExposed=false`.
|
||||
- `repo-swarm-mvp-gate` is the compact aggregate MVP proof rite. `epiphany-repo-swarm-mvp-gate-smoke` consumes the latest fresh-repo MVP, repo-work readiness, and Bifrost accounting-bundle summaries, verifies the green proof rows, and leaves Idunn elevated service execution plus unattended daemon survival as explicit warning gates instead of laundering them into completion. Wrapper mode `tools/epiphany_local_run.ps1 -Mode repo-swarm-mvp-gate` proved `.epiphany-smoke\repo-swarm-mvp-gate-20260621-134522` via wrapper artifact `local-20260621-144521-724-cdadf70f`: `demoReady=True`, `mvpReady=False`, `green=11`, `warnings=2`, `blockers=0`, and `privateStateExposed=False`.
|
||||
- `daemon-survival-rehearsal` is the bounded Idunn physiology proof. `epiphany-daemon-survival-rehearsal-smoke` writes a durable restart policy for `epiphany-daemon-self`, runs `epiphany-daemon-supervisor serve --max-iterations 2 --force --loop-interval-seconds 0`, verifies two scheduler pulses and the scheduler receipt row, and keeps service-manager mutation/elevation/private-state exposure false. Wrapper proof `tools/epiphany_local_run.ps1 -Mode daemon-survival-rehearsal -SkipBuild` emitted `.epiphany-smoke\daemon-survival-rehearsal-20260621-135723` via artifact `local-20260621-145723-011-1175e273`.
|
||||
- `repo-swarm-mvp-gate` is the compact aggregate MVP proof rite. `epiphany-repo-swarm-mvp-gate-smoke` consumes the latest fresh-repo MVP, repo-work readiness, Bifrost accounting-bundle, and daemon survival summaries, verifies the green proof rows, and leaves only Idunn elevated service execution as an explicit warning gate instead of laundering it into completion. Wrapper mode `tools/epiphany_local_run.ps1 -Mode repo-swarm-mvp-gate` proved `.epiphany-smoke\repo-swarm-mvp-gate-20260621-135754` via wrapper artifact `local-20260621-145752-946-d1d4d118`: `demoReady=True`, `mvpReady=False`, `green=12`, `warnings=1`, `blockers=0`, and `privateStateExposed=False`.
|
||||
- `bifrost-ledger` is the compact Bifrost/Imagination readback rite; use it after collaboration, publication, accepted-artifact, or metrics writes to see the latest body-change, public-proof, accepted-artifact, metrics, GitHub, feedback, consensus, credit/review-count, and accounting closure rows without opening the full local Verse.
|
||||
- `tool-directory` is the non-mutating daemon tool sight rite; it shows which globally available daemon-hosted tools any agent can invoke through typed intents and receipts, while still exposing host readiness.
|
||||
- `tool-invoke` now embeds compact readbacks for common daemon-hosted tools. Status calls return `daemonStatusReadback`, Eve calls return `eveConnectionReadback`, Self `service-health` returns Idunn-owned `serviceHealthReadback`, Self `service-policy-directory` returns Idunn-owned `servicePolicyDirectoryReadback`, Self `swarm-online-runbook` returns Idunn-owned `swarmOnlineRunbookReadback`, and Hands/Soul authority tools return `authorityToolReadback` with gate, input contract, receipt contract, intent/receipt routes, host cluster, and private-state seal. This proves global tool ergonomics without moving action, verification, or daemon lifecycle ownership into the wrapper; live proofs routed Persona to Hands `repo-action` (`local-20260619-021628-143-7bf7f2e0`), Soul `verify` (`local-20260619-021701-458-852cfa6f`), Self `swarm-online-runbook` (`local-20260619-032244-273-acb3c6a4`), and Self `service-policy-directory` (`local-20260619-035238-138-633f3ff0`) with `privateStateExposed=false`.
|
||||
|
|
|
|||
Binary file not shown.
File diff suppressed because one or more lines are too long
|
|
@ -1,5 +1,5 @@
|
|||
param(
|
||||
[ValidateSet("status", "plan", "smoke", "run", "mvp", "agent-state-soa", "swarm-status", "swarm-poke-down", "swarm-triage", "cluster-topology", "eve-surfaces", "eve-connect", "collaboration-feedback", "repo-swarm-mvp-gate", "bifrost-publication", "bifrost-public-proof", "bifrost-artifact-acceptance", "bifrost-metrics", "bifrost-accounting-bundle", "bifrost-ledger", "receipt-directory", "tool-directory", "tool-invoke", "swarm-overview", "gjallar", "repo-persona-intake", "repo-swarm-run", "repo-work-queue-run", "repo-work-readiness", "repo-work-readiness-review", "repo-deployment-config-audit", "repo-deployment-runbook", "repo-deployment-aftercare-audit", "repo-work-service-plan", "repo-work-service-runbook", "repo-work-service-launch", "repo-work-service-audit", "swarm-online-runbook", "service-policy-directory", "service-plan", "service-launch", "service-runbook", "cluster-service-runbook", "cluster-service-install-plan", "cluster-service-install-execute", "cluster-service-audit", "cluster-service-start-plan", "cluster-service-stop-plan", "cluster-service-start-execute", "cluster-service-stop-execute", "cluster-service-execution-readiness", "cluster-service-execution-runbook", "cluster-service-execution-audit", "service-execution-runbook", "service-install-plan", "service-install-execute", "service-tick", "service-status", "service-reconcile", "service-execution-readiness", "service-execution-audit", "service-start-plan", "service-stop-plan", "service-start-execute", "service-stop-execute")]
|
||||
[ValidateSet("status", "plan", "smoke", "run", "mvp", "agent-state-soa", "swarm-status", "swarm-poke-down", "swarm-triage", "cluster-topology", "eve-surfaces", "eve-connect", "collaboration-feedback", "daemon-survival-rehearsal", "repo-swarm-mvp-gate", "bifrost-publication", "bifrost-public-proof", "bifrost-artifact-acceptance", "bifrost-metrics", "bifrost-accounting-bundle", "bifrost-ledger", "receipt-directory", "tool-directory", "tool-invoke", "swarm-overview", "gjallar", "repo-persona-intake", "repo-swarm-run", "repo-work-queue-run", "repo-work-readiness", "repo-work-readiness-review", "repo-deployment-config-audit", "repo-deployment-runbook", "repo-deployment-aftercare-audit", "repo-work-service-plan", "repo-work-service-runbook", "repo-work-service-launch", "repo-work-service-audit", "swarm-online-runbook", "service-policy-directory", "service-plan", "service-launch", "service-runbook", "cluster-service-runbook", "cluster-service-install-plan", "cluster-service-install-execute", "cluster-service-audit", "cluster-service-start-plan", "cluster-service-stop-plan", "cluster-service-start-execute", "cluster-service-stop-execute", "cluster-service-execution-readiness", "cluster-service-execution-runbook", "cluster-service-execution-audit", "service-execution-runbook", "service-install-plan", "service-install-execute", "service-tick", "service-status", "service-reconcile", "service-execution-readiness", "service-execution-audit", "service-start-plan", "service-stop-plan", "service-start-execute", "service-stop-execute")]
|
||||
[string]$Mode = "smoke",
|
||||
[string]$Root = (Resolve-Path ".").Path,
|
||||
[string]$Workspace = "",
|
||||
|
|
@ -58,6 +58,7 @@ param(
|
|||
[string]$RepoSwarmMvpFreshRepoSummaryPath = "",
|
||||
[string]$RepoSwarmMvpReadinessSummaryPath = "",
|
||||
[string]$RepoSwarmMvpBifrostAccountingSummaryPath = "",
|
||||
[string]$RepoSwarmMvpDaemonSurvivalSummaryPath = "",
|
||||
[string]$ToolCapabilityId = "epiphany.cluster.hands.tool.repo-action",
|
||||
[string]$ToolRequestingAgentId = "epiphany.Persona",
|
||||
[string]$ToolRequestingClusterId = "epiphany.cluster.persona",
|
||||
|
|
@ -335,6 +336,7 @@ $statusExe = Join-Path $TargetDir "debug\epiphany-mvp-status.exe"
|
|||
$operatorRunExe = Join-Path $TargetDir "debug\epiphany-operator-run.exe"
|
||||
$operatorSnapshotExe = Join-Path $TargetDir "debug\epiphany-operator-snapshot.exe"
|
||||
$verseQueryExe = Join-Path $TargetDir "debug\epiphany-verse-query.exe"
|
||||
$daemonSurvivalRehearsalExe = Join-Path $TargetDir "debug\epiphany-daemon-survival-rehearsal-smoke.exe"
|
||||
$repoSwarmMvpGateExe = Join-Path $TargetDir "debug\epiphany-repo-swarm-mvp-gate-smoke.exe"
|
||||
$bifrostAccountingBundleExe = Join-Path $TargetDir "debug\epiphany-repo-bifrost-accounting-bundle-smoke.exe"
|
||||
$swarmExe = Join-Path $TargetDir "debug\epiphany-swarm.exe"
|
||||
|
|
@ -381,7 +383,7 @@ $runtimeStore = Join-Path $Workspace "state\runtime-spine.msgpack"
|
|||
$liveRuntimeMode = @("run", "mvp") -contains $Mode
|
||||
|
||||
if (-not $SkipBuild) {
|
||||
if ($Mode -ne "status" -and $Mode -ne "agent-state-soa" -and $Mode -ne "swarm-status" -and $Mode -ne "swarm-poke-down" -and $Mode -ne "swarm-triage" -and $Mode -ne "cluster-topology" -and $Mode -ne "eve-surfaces" -and $Mode -ne "eve-connect" -and $Mode -ne "collaboration-feedback" -and $Mode -ne "repo-swarm-mvp-gate" -and $Mode -ne "bifrost-publication" -and $Mode -ne "bifrost-public-proof" -and $Mode -ne "bifrost-artifact-acceptance" -and $Mode -ne "bifrost-metrics" -and $Mode -ne "bifrost-accounting-bundle" -and $Mode -ne "bifrost-ledger" -and $Mode -ne "receipt-directory" -and $Mode -ne "tool-directory" -and $Mode -ne "tool-invoke" -and $Mode -ne "swarm-overview" -and $Mode -ne "gjallar" -and $Mode -ne "repo-persona-intake" -and $Mode -ne "repo-swarm-run" -and $Mode -ne "repo-work-queue-run" -and $Mode -ne "repo-work-readiness" -and $Mode -ne "repo-work-readiness-review" -and $Mode -ne "repo-deployment-config-audit" -and $Mode -ne "repo-deployment-runbook" -and $Mode -ne "repo-deployment-aftercare-audit" -and $Mode -ne "repo-work-service-plan" -and $Mode -ne "repo-work-service-runbook" -and $Mode -ne "repo-work-service-launch" -and $Mode -ne "repo-work-service-audit" -and $Mode -ne "swarm-online-runbook" -and $Mode -ne "service-policy-directory" -and $Mode -ne "service-plan" -and $Mode -ne "service-launch" -and $Mode -ne "service-runbook" -and $Mode -ne "cluster-service-runbook" -and $Mode -ne "cluster-service-install-plan" -and $Mode -ne "cluster-service-install-execute" -and $Mode -ne "cluster-service-audit" -and $Mode -ne "cluster-service-start-plan" -and $Mode -ne "cluster-service-stop-plan" -and $Mode -ne "cluster-service-start-execute" -and $Mode -ne "cluster-service-stop-execute" -and $Mode -ne "cluster-service-execution-readiness" -and $Mode -ne "cluster-service-execution-runbook" -and $Mode -ne "cluster-service-execution-audit" -and $Mode -ne "service-execution-runbook" -and $Mode -ne "service-install-plan" -and $Mode -ne "service-install-execute" -and $Mode -ne "service-tick" -and $Mode -ne "service-status" -and $Mode -ne "service-reconcile" -and $Mode -ne "service-execution-readiness" -and $Mode -ne "service-execution-audit" -and $Mode -ne "service-start-plan" -and $Mode -ne "service-stop-plan" -and $Mode -ne "service-start-execute" -and $Mode -ne "service-stop-execute") {
|
||||
if ($Mode -ne "status" -and $Mode -ne "agent-state-soa" -and $Mode -ne "swarm-status" -and $Mode -ne "swarm-poke-down" -and $Mode -ne "swarm-triage" -and $Mode -ne "cluster-topology" -and $Mode -ne "eve-surfaces" -and $Mode -ne "eve-connect" -and $Mode -ne "collaboration-feedback" -and $Mode -ne "daemon-survival-rehearsal" -and $Mode -ne "repo-swarm-mvp-gate" -and $Mode -ne "bifrost-publication" -and $Mode -ne "bifrost-public-proof" -and $Mode -ne "bifrost-artifact-acceptance" -and $Mode -ne "bifrost-metrics" -and $Mode -ne "bifrost-accounting-bundle" -and $Mode -ne "bifrost-ledger" -and $Mode -ne "receipt-directory" -and $Mode -ne "tool-directory" -and $Mode -ne "tool-invoke" -and $Mode -ne "swarm-overview" -and $Mode -ne "gjallar" -and $Mode -ne "repo-persona-intake" -and $Mode -ne "repo-swarm-run" -and $Mode -ne "repo-work-queue-run" -and $Mode -ne "repo-work-readiness" -and $Mode -ne "repo-work-readiness-review" -and $Mode -ne "repo-deployment-config-audit" -and $Mode -ne "repo-deployment-runbook" -and $Mode -ne "repo-deployment-aftercare-audit" -and $Mode -ne "repo-work-service-plan" -and $Mode -ne "repo-work-service-runbook" -and $Mode -ne "repo-work-service-launch" -and $Mode -ne "repo-work-service-audit" -and $Mode -ne "swarm-online-runbook" -and $Mode -ne "service-policy-directory" -and $Mode -ne "service-plan" -and $Mode -ne "service-launch" -and $Mode -ne "service-runbook" -and $Mode -ne "cluster-service-runbook" -and $Mode -ne "cluster-service-install-plan" -and $Mode -ne "cluster-service-install-execute" -and $Mode -ne "cluster-service-audit" -and $Mode -ne "cluster-service-start-plan" -and $Mode -ne "cluster-service-stop-plan" -and $Mode -ne "cluster-service-start-execute" -and $Mode -ne "cluster-service-stop-execute" -and $Mode -ne "cluster-service-execution-readiness" -and $Mode -ne "cluster-service-execution-runbook" -and $Mode -ne "cluster-service-execution-audit" -and $Mode -ne "service-execution-runbook" -and $Mode -ne "service-install-plan" -and $Mode -ne "service-install-execute" -and $Mode -ne "service-tick" -and $Mode -ne "service-status" -and $Mode -ne "service-reconcile" -and $Mode -ne "service-execution-readiness" -and $Mode -ne "service-execution-audit" -and $Mode -ne "service-start-plan" -and $Mode -ne "service-stop-plan" -and $Mode -ne "service-start-execute" -and $Mode -ne "service-stop-execute") {
|
||||
Invoke-Checked `
|
||||
-Label "build Codex app-server compatibility organ" `
|
||||
-FilePath $cargoExe `
|
||||
|
|
@ -401,6 +403,7 @@ if (-not $SkipBuild) {
|
|||
"--bin", "epiphany-operator-run",
|
||||
"--bin", "epiphany-operator-snapshot",
|
||||
"--bin", "epiphany-verse-query",
|
||||
"--bin", "epiphany-daemon-survival-rehearsal-smoke",
|
||||
"--bin", "epiphany-repo-swarm-mvp-gate-smoke",
|
||||
"--bin", "epiphany-repo-bifrost-accounting-bundle-smoke",
|
||||
"--bin", "epiphany-swarm",
|
||||
|
|
@ -440,13 +443,16 @@ if (-not $SkipBuild) {
|
|||
}
|
||||
|
||||
$requiredBinaries = @($statusExe, $operatorRunExe, $operatorSnapshotExe, $verseQueryExe, $swarmExe, $repoWorkExe, $daemonSupervisorExe, $handsActionExe)
|
||||
if ($Mode -eq "daemon-survival-rehearsal") {
|
||||
$requiredBinaries += @($daemonSurvivalRehearsalExe)
|
||||
}
|
||||
if ($Mode -eq "repo-swarm-mvp-gate") {
|
||||
$requiredBinaries += @($repoSwarmMvpGateExe)
|
||||
}
|
||||
if ($Mode -eq "bifrost-accounting-bundle") {
|
||||
$requiredBinaries += @($bifrostAccountingBundleExe)
|
||||
}
|
||||
if ($Mode -ne "status" -and $Mode -ne "agent-state-soa" -and $Mode -ne "swarm-status" -and $Mode -ne "swarm-poke-down" -and $Mode -ne "swarm-triage" -and $Mode -ne "cluster-topology" -and $Mode -ne "eve-surfaces" -and $Mode -ne "eve-connect" -and $Mode -ne "collaboration-feedback" -and $Mode -ne "repo-swarm-mvp-gate" -and $Mode -ne "bifrost-publication" -and $Mode -ne "bifrost-public-proof" -and $Mode -ne "bifrost-artifact-acceptance" -and $Mode -ne "bifrost-metrics" -and $Mode -ne "bifrost-accounting-bundle" -and $Mode -ne "bifrost-ledger" -and $Mode -ne "receipt-directory" -and $Mode -ne "tool-directory" -and $Mode -ne "tool-invoke" -and $Mode -ne "swarm-overview" -and $Mode -ne "gjallar" -and $Mode -ne "repo-persona-intake" -and $Mode -ne "repo-swarm-run" -and $Mode -ne "repo-work-queue-run" -and $Mode -ne "repo-work-readiness" -and $Mode -ne "repo-work-readiness-review" -and $Mode -ne "repo-deployment-config-audit" -and $Mode -ne "repo-deployment-runbook" -and $Mode -ne "repo-deployment-aftercare-audit" -and $Mode -ne "repo-work-service-plan" -and $Mode -ne "repo-work-service-runbook" -and $Mode -ne "repo-work-service-launch" -and $Mode -ne "repo-work-service-audit" -and $Mode -ne "swarm-online-runbook" -and $Mode -ne "service-policy-directory" -and $Mode -ne "service-plan" -and $Mode -ne "service-launch" -and $Mode -ne "service-runbook" -and $Mode -ne "cluster-service-runbook" -and $Mode -ne "cluster-service-install-plan" -and $Mode -ne "cluster-service-install-execute" -and $Mode -ne "cluster-service-audit" -and $Mode -ne "cluster-service-start-plan" -and $Mode -ne "cluster-service-stop-plan" -and $Mode -ne "cluster-service-start-execute" -and $Mode -ne "cluster-service-stop-execute" -and $Mode -ne "cluster-service-execution-readiness" -and $Mode -ne "cluster-service-execution-runbook" -and $Mode -ne "cluster-service-execution-audit" -and $Mode -ne "service-execution-runbook" -and $Mode -ne "service-install-plan" -and $Mode -ne "service-install-execute" -and $Mode -ne "service-tick" -and $Mode -ne "service-status" -and $Mode -ne "service-reconcile" -and $Mode -ne "service-execution-readiness" -and $Mode -ne "service-execution-audit" -and $Mode -ne "service-start-plan" -and $Mode -ne "service-stop-plan" -and $Mode -ne "service-start-execute" -and $Mode -ne "service-stop-execute") {
|
||||
if ($Mode -ne "status" -and $Mode -ne "agent-state-soa" -and $Mode -ne "swarm-status" -and $Mode -ne "swarm-poke-down" -and $Mode -ne "swarm-triage" -and $Mode -ne "cluster-topology" -and $Mode -ne "eve-surfaces" -and $Mode -ne "eve-connect" -and $Mode -ne "collaboration-feedback" -and $Mode -ne "daemon-survival-rehearsal" -and $Mode -ne "repo-swarm-mvp-gate" -and $Mode -ne "bifrost-publication" -and $Mode -ne "bifrost-public-proof" -and $Mode -ne "bifrost-artifact-acceptance" -and $Mode -ne "bifrost-metrics" -and $Mode -ne "bifrost-accounting-bundle" -and $Mode -ne "bifrost-ledger" -and $Mode -ne "receipt-directory" -and $Mode -ne "tool-directory" -and $Mode -ne "tool-invoke" -and $Mode -ne "swarm-overview" -and $Mode -ne "gjallar" -and $Mode -ne "repo-persona-intake" -and $Mode -ne "repo-swarm-run" -and $Mode -ne "repo-work-queue-run" -and $Mode -ne "repo-work-readiness" -and $Mode -ne "repo-work-readiness-review" -and $Mode -ne "repo-deployment-config-audit" -and $Mode -ne "repo-deployment-runbook" -and $Mode -ne "repo-deployment-aftercare-audit" -and $Mode -ne "repo-work-service-plan" -and $Mode -ne "repo-work-service-runbook" -and $Mode -ne "repo-work-service-launch" -and $Mode -ne "repo-work-service-audit" -and $Mode -ne "swarm-online-runbook" -and $Mode -ne "service-policy-directory" -and $Mode -ne "service-plan" -and $Mode -ne "service-launch" -and $Mode -ne "service-runbook" -and $Mode -ne "cluster-service-runbook" -and $Mode -ne "cluster-service-install-plan" -and $Mode -ne "cluster-service-install-execute" -and $Mode -ne "cluster-service-audit" -and $Mode -ne "cluster-service-start-plan" -and $Mode -ne "cluster-service-stop-plan" -and $Mode -ne "cluster-service-start-execute" -and $Mode -ne "cluster-service-stop-execute" -and $Mode -ne "cluster-service-execution-readiness" -and $Mode -ne "cluster-service-execution-runbook" -and $Mode -ne "cluster-service-execution-audit" -and $Mode -ne "service-execution-runbook" -and $Mode -ne "service-install-plan" -and $Mode -ne "service-install-execute" -and $Mode -ne "service-tick" -and $Mode -ne "service-status" -and $Mode -ne "service-reconcile" -and $Mode -ne "service-execution-readiness" -and $Mode -ne "service-execution-audit" -and $Mode -ne "service-start-plan" -and $Mode -ne "service-stop-plan" -and $Mode -ne "service-start-execute" -and $Mode -ne "service-stop-execute") {
|
||||
$requiredBinaries += @($codexAppServer, $coordinatorExe)
|
||||
}
|
||||
function Assert-SwarmBrakeAllowsLiveRun {
|
||||
|
|
@ -609,7 +615,7 @@ Invoke-Checked `
|
|||
-StdoutPath (Join-Path $artifactRoot "operator-run-intent.stdout.json") `
|
||||
-StderrPath (Join-Path $artifactRoot "operator-run-intent.stderr.log")
|
||||
|
||||
$compactReadOnlyModes = @("agent-state-soa", "swarm-status", "swarm-poke-down", "swarm-triage", "cluster-topology", "eve-surfaces", "eve-connect", "collaboration-feedback", "repo-swarm-mvp-gate", "bifrost-publication", "bifrost-public-proof", "bifrost-artifact-acceptance", "bifrost-metrics", "bifrost-accounting-bundle", "bifrost-ledger", "receipt-directory", "tool-directory", "tool-invoke", "swarm-overview", "gjallar", "swarm-online-runbook", "service-policy-directory")
|
||||
$compactReadOnlyModes = @("agent-state-soa", "swarm-status", "swarm-poke-down", "swarm-triage", "cluster-topology", "eve-surfaces", "eve-connect", "collaboration-feedback", "daemon-survival-rehearsal", "repo-swarm-mvp-gate", "bifrost-publication", "bifrost-public-proof", "bifrost-artifact-acceptance", "bifrost-metrics", "bifrost-accounting-bundle", "bifrost-ledger", "receipt-directory", "tool-directory", "tool-invoke", "swarm-overview", "gjallar", "swarm-online-runbook", "service-policy-directory")
|
||||
$isCompactReadOnlyMode = $compactReadOnlyModes -contains $Mode
|
||||
$shouldReadLocalVerse = $Mode -ne "smoke" -and -not $isCompactReadOnlyMode
|
||||
if ($shouldReadLocalVerse -and $Mode -ne "status" -and $Mode -ne "mvp") {
|
||||
|
|
@ -976,6 +982,20 @@ if ($Mode -eq "bifrost-metrics") {
|
|||
-StderrPath (Join-Path $artifactRoot "bifrost-metrics.stderr.log")
|
||||
}
|
||||
|
||||
if ($Mode -eq "daemon-survival-rehearsal") {
|
||||
$resultPath = Join-Path $artifactRoot "daemon-survival-rehearsal.stdout.json"
|
||||
Invoke-Checked `
|
||||
-Label "verify Idunn daemon survival rehearsal" `
|
||||
-FilePath $daemonSurvivalRehearsalExe `
|
||||
-Arguments @(
|
||||
"--root", $Root,
|
||||
"--smoke-root", (Join-Path $Root ".epiphany-smoke")
|
||||
) `
|
||||
-WorkingDirectory $Root `
|
||||
-StdoutPath $resultPath `
|
||||
-StderrPath (Join-Path $artifactRoot "daemon-survival-rehearsal.stderr.log")
|
||||
}
|
||||
|
||||
if ($Mode -eq "repo-swarm-mvp-gate") {
|
||||
$resultPath = Join-Path $artifactRoot "repo-swarm-mvp-gate.stdout.json"
|
||||
$gateArgs = @(
|
||||
|
|
@ -991,6 +1011,9 @@ if ($Mode -eq "repo-swarm-mvp-gate") {
|
|||
if ($RepoSwarmMvpBifrostAccountingSummaryPath -ne "") {
|
||||
$gateArgs += @("--bifrost-accounting-summary", $RepoSwarmMvpBifrostAccountingSummaryPath)
|
||||
}
|
||||
if ($RepoSwarmMvpDaemonSurvivalSummaryPath -ne "") {
|
||||
$gateArgs += @("--daemon-survival-summary", $RepoSwarmMvpDaemonSurvivalSummaryPath)
|
||||
}
|
||||
Invoke-Checked `
|
||||
-Label "verify repo swarm MVP gate proof" `
|
||||
-FilePath $repoSwarmMvpGateExe `
|
||||
|
|
@ -2616,6 +2639,8 @@ if ($resultPath -ne "" -and (Test-Path -LiteralPath $resultPath)) {
|
|||
$creditReadback = ($result.creditReadbackReceiptIds -join ",")
|
||||
}
|
||||
Write-Host "Bifrost metrics: status=$($result.status), item=$($result.item), receipt=$($result.receiptId), artifactAcceptance=$($result.artifactAcceptanceReceiptId), modelSpend=$modelSpend, reviewLoad=$reviewLoad, creditReadback=$creditReadback, privateStateExposed=$($result.privateStateExposed)"
|
||||
} elseif ($Mode -eq "daemon-survival-rehearsal") {
|
||||
Write-Host "Daemon survival rehearsal: status=$($result.status), daemon=$($result.daemonId), scheduler=$($result.schedulerId), policy=$($result.policyStatus), serve=$($result.serveStatus), iterations=$($result.serveIterations), schedulerReceipt=$($result.schedulerReceiptId), serviceManagerMutated=$($result.serviceManagerMutated), elevated=$($result.requiresElevatedAuthority), privateStateExposed=$($result.privateStateExposed), smokeDir=$($result.smokeDir)"
|
||||
} elseif ($Mode -eq "repo-swarm-mvp-gate") {
|
||||
$remaining = "none"
|
||||
if ($null -ne $result.knownRemainingAuthorityGates -and $result.knownRemainingAuthorityGates.Count -gt 0) {
|
||||
|
|
|
|||
Reference in a new issue