Struct Journal 

pub struct Journal {
    pub dir: PathBuf,
    /* private fields */
}

One open journal.

Fields

dir: PathBuf

The run’s directory.

Implementations

impl Journal

pub fn create( command: &str, target: &str, forge: &str, repo: &str, ) -> Result<Self>

Create the run directory — before any remote mutation — pruning the oldest runs past the cap first.

Errors

Any filesystem failure; the caller decides whether that refuses the run (apply) or only costs the record (preview and check).

pub fn run_id(&self) -> &str

The run’s identifier.

pub fn scripts_dir(&self) -> PathBuf

The directory the run’s scripts materialize into.

pub fn event_line(&mut self, line: &str)

Append one already-serialized event line.

pub fn transcript(&mut self, bytes: &[u8])

Append raw bytes to the transcript, in arrival order.

pub fn record_script(&mut self, path: String, sha256: String)

Record one materialized script’s digest.

pub fn record_secret( &mut self, secret: &str, present: bool, source: &'static str, )

Record one secret’s handling: where the value came from, and how it reached the forge CLI. A key file is file, because the environment carried only its path.

pub fn finish(&mut self, exit_code: i32, reason: Option<&str>)

Close the run: record the terminal status, and remove the materialized scripts on clean completion so a failed run keeps exactly the script that ran beside the transcript of what it did.

Trait Implementations

impl Debug for Journal

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.