workspace-mgr 0.4.1

Fixed-policy repository workspace manager for coding agents
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

pub const TASK_DIRECTORY_PATTERN: &str = "%Y%m%d-%H%M%S-{slug}";
pub const TASK_MANIFEST_NAME: &str = ".workspace-mgr-task.toml";
pub const TASK_BRANCH_PREFIX: &str = "codex/";
pub const ROOT_IGNORE_NAME: &str = ".gitignore";
pub const REPOSITORY_IGNORE_MODULE: &str = ".workspace-mgr/repository.gitignore";
pub const REPOSITORY_MODULE_MAX_BYTES: usize = 65_536;
pub const RECOMMENDED_S3_MINIMUM_BYTES: u64 = 1_048_576;
pub const AUTO_S3_ABOVE_BYTES: u64 = 10_485_760;
pub const BULK_PUBLICATION_FILES: u64 = 200;
pub const BULK_PUBLICATION_BYTES: u64 = 268_435_456;
/// The byte threshold in the unit every rendered rule and document states it
/// in, derived from the threshold itself so the two cannot disagree.
pub const BULK_PUBLICATION_MIB: u64 = BULK_PUBLICATION_BYTES / 1_048_576;
pub const CLOUD_USAGE_APPROVAL_BYTES: u64 = 1_073_741_824;
pub const INSTRUCTION_POLICY_VERSION: u32 = 11;
/// The first workspace-mgr release that reads task manifest schema 3, which
/// adds the optional `[cloud_usage_approval]` table.
pub const TASK_SCHEMA_3_MINIMUM_CLI_VERSION: semver::Version = semver::Version::new(0, 4, 0);

pub const REVIEW_PULL_REQUEST: &str = "required";
pub const REVIEW_INITIAL_STATE: &str = "draft";
pub const REVIEW_MANAGED_BY: &str = "agent";
pub const REVIEW_MERGE_AUTHORITY: &str = "user";
pub const REVIEW_DELIVERABLE_CREATION_TIMING: &str = "immediate-after-scaffold-publication";
pub const REVIEW_INFRASTRUCTURE_CREATION_TIMING: &str = "after-first-scoped-publication";
pub const REVIEW_SYNC_CADENCE: &str = "before-every-turn-end";

/// The oldest workspace-mgr version able to read a task manifest of this
/// schema, or `None` when every release that knows the schema can read it.
pub fn minimum_cli_version_for_task_schema(schema_version: u32) -> Option<semver::Version> {
    match schema_version {
        3 => Some(TASK_SCHEMA_3_MINIMUM_CLI_VERSION),
        _ => None,
    }
}

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

    #[test]
    fn only_task_manifest_schema_3_raises_the_minimum_cli_version() {
        assert_eq!(minimum_cli_version_for_task_schema(1), None);
        assert_eq!(minimum_cli_version_for_task_schema(2), None);
        assert_eq!(
            minimum_cli_version_for_task_schema(3).map(|version| version.to_string()),
            Some("0.4.0".to_owned())
        );
    }

    /// Publication writes each schema's minimum release into repositories and
    /// refuses to write one the build does not meet, so a release whose
    /// package version is below any mapped minimum could not publish that
    /// schema. The package version is read directly, never through the
    /// test-only release override, and the `production_build_` prefix makes
    /// the production-configuration CI step run it too.
    #[test]
    fn production_build_package_version_meets_every_task_schema_minimum() {
        let package = semver::Version::parse(env!("CARGO_PKG_VERSION"))
            .expect("the package version is valid semver");
        let mut mapped = 0;
        for schema in 0..=u32::from(u8::MAX) {
            let Some(required) = minimum_cli_version_for_task_schema(schema) else {
                continue;
            };
            mapped += 1;
            assert!(
                crate::config::cli_version_satisfies(&package, &required),
                "package version {package} is below the workspace-mgr {required} that task manifest schema {schema} requires; release this schema as {required} or newer"
            );
        }
        assert!(
            mapped > 0,
            "no task manifest schema maps to a minimum release"
        );
    }
}