cursus 0.5.2

Library crate for the cursus release management CLI
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

//! The `ci` subcommand — auto-detects repo state and dispatches to `prepare` or `publish`.

use std::process::ExitCode;

use clap::Args;
use log::{debug, info};

use crate::model::changeset::Changeset;
use crate::model::config::Config;
use crate::package_manager::filter_projects_by_name;

use super::{PrepareArgs, PublishArgs, cmd_prepare, cmd_publish};

/// Arguments for the `ci` subcommand.
#[derive(Args, Default)]
pub struct CiArgs {
	/// Only process specific packages (repeatable)
	#[arg(short = 'p', long = "package")]
	pub packages: Vec<String>,

	/// Override the release branch name (branch strategy only).
	///
	/// Passed through to `prepare` when pending changesets are found.
	#[arg(long)]
	pub branch: Option<String>,

	/// Skip git tag creation, tag pushing, and GitHub Releases even if enabled in config.
	///
	/// When set, the publish-state detection also falls back to "nothing to do".
	#[arg(long)]
	pub no_git: bool,
}

/// Runs the `ci` subcommand.
///
/// Auto-detects the current repository state and dispatches accordingly:
///
/// 1. Pending changesets found → run `prepare`
/// 2. No changesets, git enabled, and at least one expected tag is absent → run `publish`
/// 3. Otherwise → log "Nothing to do" and return success
///
/// This subcommand is always non-interactive.
///
/// # State detection
///
/// Post-release state (step 2) is detected by checking whether each package's expected git
/// tag exists. This is sufficient because publish is idempotent (ADR-004): if a package was
/// already published to a registry but the tag push failed, re-running `publish` will skip the
/// already-published registry step and only retry the tag. Checking registry state directly
/// would add network dependencies and is not necessary for correctness.
pub(crate) async fn cmd_ci(
	args: &CiArgs,
	dry_run: bool,
	env: &crate::Env,
	config: Config,
) -> anyhow::Result<ExitCode> {
	let git = env.git();

	// Step 1: check for pending changesets.
	let changesets = Changeset::read_all(env).await?;
	if !changesets.is_empty() {
		info!("ci: pending changesets found, running prepare");
		let prepare_args = PrepareArgs {
			packages: args.packages.clone(),
			no_git: args.no_git,
			branch: args.branch.clone(),
		};
		return cmd_prepare(&prepare_args, dry_run, env, config).await;
	}

	// Step 2: when git is enabled and --no-git is not set, check for packages that
	// have not yet been tagged (post-release, pre-publish state).
	if config.git.enabled() && !args.no_git {
		let projects = config.load_projects(env).await?;
		let selected = filter_projects_by_name(&projects, &args.packages)?;
		let is_multi = projects.len() > 1;

		let mut any_tag_missing = false;
		for project in &selected {
			if !env
				.fs()
				.exists(&project.path().child("CHANGELOG.md"))
				.await?
			{
				debug!("skipping tag check for {}", project.name());
				continue;
			}
			let version = project.version();
			let tag = config.git.tag_format.tag(project.name(), version, is_multi);
			// Treat git errors as "tag not found" — conservative, triggers publish.
			if !git.tag_exists(&tag).await.unwrap_or(false) {
				any_tag_missing = true;
				break;
			}
		}

		if any_tag_missing {
			info!("ci: no changesets but unpublished tags detected, running publish");
			let publish_args = PublishArgs {
				packages: args.packages.clone(),
				no_git: args.no_git,
			};
			return cmd_publish(&publish_args, dry_run, env, config).await;
		}
	}

	info!("ci: nothing to do");
	Ok(ExitCode::SUCCESS)
}

#[cfg(test)]
mod tests {
	use super::*;

	#[test]
	fn ci_args_default() {
		let args = CiArgs::default();
		assert!(args.packages.is_empty());
		assert!(args.branch.is_none());
		assert!(!args.no_git);
	}
}