lernie 0.0.6

A git-backed agent harness
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! `lernie config` — author a config commit beyond `lernie new` (ARCH
//! §2.2, §2.3): the only act besides `new` that advances a config
//! branch. The interactive `$EDITOR` hand-off arrives through
//! [`Fx::editor`](super::Fx::editor); everything else lives in
//! [`crate::template::authoring::from_cli`].

use super::{Error, Fx, Outcome};
use crate::harness_root;
use crate::template::authoring::Pass;
use crate::template::{self, RealGit};
use std::path::PathBuf;

/// `lernie config <workspace> [<name>] [--from <source>] [--orphan]`.
#[derive(clap::Args, Debug)]
pub struct Args {
    /// Path to the workspace (conversation repo) root.
    pub workspace: PathBuf,
    /// Config branch to author on (`config/<name>`); defaults to `default`.
    pub name: Option<String>,
    /// Fork a new branch off `config/<source>` instead of advancing.
    #[arg(long)]
    pub from: Option<String>,
    /// Start a fresh orphan lineage instead of advancing.
    #[arg(long)]
    pub orphan: bool,
}

/// Materialize, edit via [`Fx::editor`](super::Fx::editor), and commit —
/// product-less when the commit lands (§3.4). A **declined pass** — an
/// edit that changed nothing — is not a failure: it exits 0 and reports
/// the branch that did not move as the verb's one stdout line, which is
/// also the machine-readable signal (empty stdout = a commit landed).
/// Failures — root resolution or the authoring pass — carry the `config`
/// prefix through one conversion.
pub fn run(args: Args, fx: &mut Fx) -> Result<Outcome, Error> {
    go(args, fx).map_err(|e| Error::new("config", e))
}

fn go(args: Args, fx: &mut Fx) -> Result<Outcome, Box<dyn std::error::Error>> {
    let roots = harness_root::resolve()?;
    let pass = template::authoring::from_cli(
        &args.workspace,
        &roots.data,
        args.name.as_deref(),
        args.from.as_deref(),
        args.orphan,
        fx.editor,
        &RealGit::new(),
    )?;
    Ok(match pass {
        Pass::Landed => Outcome::Quiet,
        Pass::Declined { target } => Outcome::Line(format!(
            "{target} unchanged: the edit changed nothing, so no config commit was authored"
        )),
    })
}