spec-driven-docs 0.9.0

Spec-driven documentation: current specs, immutable decision records, and executable gates kept coherent for people and coding agents.
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

//! `upgrade` subcommand: runtime-shape.
//!
//! Resolves the target, runs the upgrader, prints its report, and turns
//! conflicts or unfinished removals into the red exit. Upgrade semantics
//! live in `services::upgrader`.

use crate::cli::upgrade::UpgradeArgs;
use crate::context::AppContext;
use crate::error::AppError;
use crate::output;
use crate::services::upgrader::{UpgradeOptions, upgrade};

/// Upgrade an installed instance to this binary's version.
///
/// # Errors
///
/// [`AppError::Violations`] on conflicts or unfinished removals; whatever
/// the upgrader refuses otherwise.
pub fn run(ctx: &AppContext, args: UpgradeArgs) -> Result<(), AppError> {
    let target = if args.target.is_absolute() {
        args.target
    } else if args.target == "." {
        ctx.cwd.clone()
    } else {
        return Err(AppError::Usage("target must be absolute or .".to_string()));
    };
    crate::commands::front::serves(crate::plan::classify::Intent::Upgrade, &target)?;
    let selections = crate::plan::decision::parse(&args.set)
        .map_err(|error| AppError::Usage(error.to_string()))?;
    let outcome = upgrade(
        &UpgradeOptions {
            target,
            dry_run: args.dry_run,
            selections,
        },
        &crate::release::embedded::EmbeddedReleaseBundle::new(),
    )?;
    for line in &outcome.lines {
        output::line(line);
    }
    if outcome.failures > 0 {
        return Err(AppError::Violations {
            count: outcome.failures,
        });
    }
    Ok(())
}