release(3.0.0-beta.1): product version migration, beta gates, archive tooling and developer docs
ci/woodpecker/push/main Pipeline was successful
ci/woodpecker/manual/performance Pipeline was successful
Linux strict security lane (G-C) / strict isolation escape matrix (push) Canceled after 0s
CI / fmt + clippy + test (Linux x86_64) (push) Canceled after 0s
CI / schema instance validation + consumers (push) Canceled after 0s
CI / runtime contract (macos-latest) (push) Canceled after 0s
CI / runtime contract (windows-latest) (push) Canceled after 0s
CI / release evidence manifest (push) Canceled after 0s
CI / release candidate artifact (macos-latest) (push) Canceled after 0s
CI / release candidate artifact (ubuntu-latest) (push) Canceled after 0s
ci/woodpecker/push/main Pipeline was successful
ci/woodpecker/manual/performance Pipeline was successful
Linux strict security lane (G-C) / strict isolation escape matrix (push) Canceled after 0s
CI / fmt + clippy + test (Linux x86_64) (push) Canceled after 0s
CI / schema instance validation + consumers (push) Canceled after 0s
CI / runtime contract (macos-latest) (push) Canceled after 0s
CI / runtime contract (windows-latest) (push) Canceled after 0s
CI / release evidence manifest (push) Canceled after 0s
CI / release candidate artifact (macos-latest) (push) Canceled after 0s
CI / release candidate artifact (ubuntu-latest) (push) Canceled after 0s
REL-01: workspace/CLI/Analysis product version 3.0.0-beta.1 with updated Cargo.lock; project.marqdo is enforced against the running core with package.marqdo_range_invalid/package.marqdo_incompatible fail-closed diagnostics; Tool SemVer prerelease negotiation tests; init template and examples use the beta range. Verify init derives the project name from the target directory instead of falling back to 'example'. REL-02: beta support matrix is Linux x86_64 only; macOS/Windows are explicitly experimental/unclaimed; strict policy and G4 Beta-only WARN are documented for the release evidence. REL-03: deterministic release packaging (tools/release/package.py) ships the CLI and provider worker together with SOURCE_SHA, RELEASE_INFO.json, known-limitations, specs, developer docs, examples incl. built plugin/provider artifacts and consumers; tools/release/smoke.py cold-install tests the archive. REL-04: docs/developers entry pages; corrected and self-contained third-party integration handbook; stale Proposed/native-only/informational spec claims fixed; release/status/compatibility/changelog/releasing docs updated. REL-05: release_evidence.py gains an explicit beta profile (BETA_RELEASE_CANDIDATE) distinct from the stable profile; Woodpecker build step now packages and smoke-tests the archive on every pipeline. Adds a runnable Resource Provider v2 example and corrects check --emit to Analysis v2.
This commit is contained in:
1 parent
56189b176c
commit
2c7c4f31e7
55 files changed
+3136
-453
No files matched your search
@@ -13,6 +13,13 @@ pub fn init(dir: Option<&Path>) -> i32 {
|
||||
);
|
||||
return 1;
|
||||
}
|
||||
if let Err(error) = std::fs::create_dir_all(dir) {
|
||||
eprintln!("error: cannot create {}: {error}", dir.display());
|
||||
return 1;
|
||||
}
|
||||
// Create the directory before canonicalizing: `init new-project` must name
|
||||
// the project `new-project`, not silently fall back to `example` because
|
||||
// the path did not exist yet.
|
||||
let name = dir
|
||||
.canonicalize()
|
||||
.ok()
|
||||
@@ -21,10 +28,6 @@ pub fn init(dir: Option<&Path>) -> i32 {
|
||||
.map(|name| name.to_string_lossy().to_string())
|
||||
})
|
||||
.unwrap_or_else(|| "example".to_string());
|
||||
if let Err(error) = std::fs::create_dir_all(dir) {
|
||||
eprintln!("error: cannot create {}: {error}", dir.display());
|
||||
return 1;
|
||||
}
|
||||
let manifest = marqdo_package::Manifest::template(&name);
|
||||
if let Err(error) = std::fs::write(dir.join(marqdo_package::MANIFEST_FILE), manifest.to_yaml())
|
||||
{
|
||||
|
||||
@@ -232,7 +232,7 @@ struct CheckArgs {
|
||||
/// Declare a plugin manifest for static export-signature checking.
|
||||
#[arg(long = "plugin", value_name = "PATH")]
|
||||
plugin: Vec<PathBuf>,
|
||||
/// Write the public Analysis v1 projection (only on successful check).
|
||||
/// Write the public Analysis v2 projection (only on successful check).
|
||||
#[arg(long, value_name = "PATH")]
|
||||
emit: Option<PathBuf>,
|
||||
/// Machine readable JSON output.
|
||||
@@ -380,7 +380,7 @@ struct ToolRemoveArgs {
|
||||
|
||||
#[derive(Args)]
|
||||
struct SyncArgs {
|
||||
/// Fail instead of silently updating when the lockfile is stale.
|
||||
/// Do not fetch pinned Git revisions; verify and materialize only from the local cache.
|
||||
#[arg(long)]
|
||||
locked: bool,
|
||||
/// Machine readable JSON output.
|
||||
|
||||
@@ -143,6 +143,11 @@ fn init_creates_a_runnable_project() {
|
||||
let output = cli(dir.path(), &["init", "proj"]);
|
||||
assert_exit(&output, 0, "init must succeed");
|
||||
assert!(stdout_text(&output).contains("Initialized Marqdo project"));
|
||||
let manifest = std::fs::read_to_string(dir.path().join("proj/marqdo.yaml")).unwrap();
|
||||
assert!(
|
||||
manifest.contains("name: proj"),
|
||||
"init must derive the project name from the target directory: {manifest}"
|
||||
);
|
||||
let project = dir.path().join("proj");
|
||||
assert!(project.join("marqdo.yaml").is_file(), "manifest missing");
|
||||
assert!(
|
||||
|
||||
@@ -434,3 +434,32 @@ fn tampered_path_dependency_content_is_rejected_by_locked_sync() {
|
||||
"a failed locked operation must not replace the materialized environment"
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn incompatible_project_marqdo_range_fails_closed_before_program_load() {
|
||||
let dir = TempDir::new("runtime-range");
|
||||
let root = dir.path();
|
||||
write(
|
||||
&root.join("marqdo.yaml"),
|
||||
"project:\n name: stale\n version: 0.1.0\n marqdo: \">=0.1,<1\"\n",
|
||||
);
|
||||
write(&root.join("index.mq.md"), "## @exec main\n\n`return 1`\n");
|
||||
for command in [["check", "index.mq.md"], ["run", "index.mq.md"]] {
|
||||
let output = cli(root, &command);
|
||||
assert!(
|
||||
!output.status.success(),
|
||||
"{} must fail closed: {}",
|
||||
command[0],
|
||||
String::from_utf8_lossy(&output.stderr)
|
||||
);
|
||||
let stderr = String::from_utf8_lossy(&output.stderr);
|
||||
assert!(
|
||||
stderr.contains("package.marqdo_incompatible"),
|
||||
"unexpected stderr: {stderr}"
|
||||
);
|
||||
assert!(
|
||||
stderr.contains(env!("CARGO_PKG_VERSION")),
|
||||
"diagnostic must name the running core: {stderr}"
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -95,7 +95,7 @@ fn write_tool(dir: &Path, command: &str, _script: &str) -> PathBuf {
|
||||
std::fs::write(
|
||||
&manifest,
|
||||
format!(
|
||||
r#"{{"schema":"marqdo.cli-tool","schema_version":1,"name":"demo.{command}","version":"0.1.0","command":"{command}","entrypoint":"{entrypoint}","compatibility":{{"marqdo":">=0.1,<1"}}}}"#
|
||||
r#"{{"schema":"marqdo.cli-tool","schema_version":1,"name":"demo.{command}","version":"0.1.0","command":"{command}","entrypoint":"{entrypoint}","compatibility":{{"marqdo":">=3.0.0-beta.1,<4.0.0"}}}}"#
|
||||
),
|
||||
)
|
||||
.unwrap();
|
||||
@@ -142,7 +142,7 @@ fn write_sample_from_source(dir: &Path, command: &str) -> PathBuf {
|
||||
std::fs::write(
|
||||
&manifest,
|
||||
format!(
|
||||
r#"{{"schema":"marqdo.cli-tool","schema_version":1,"name":"demo.{command}","version":"0.1.0","command":"{command}","entrypoint":"{entrypoint}","compatibility":{{"marqdo":">=0.1,<1","analysis":[2],"trace":[2]}}}}"#
|
||||
r#"{{"schema":"marqdo.cli-tool","schema_version":1,"name":"demo.{command}","version":"0.1.0","command":"{command}","entrypoint":"{entrypoint}","compatibility":{{"marqdo":">=3.0.0-beta.1,<4.0.0","analysis":[2],"trace":[2]}}}}"#
|
||||
),
|
||||
)
|
||||
.unwrap();
|
||||
@@ -301,7 +301,7 @@ fn invalid_manifests_and_path_escapes_are_rejected() {
|
||||
|
||||
let incompatible = std::fs::read_to_string(&manifest)
|
||||
.unwrap()
|
||||
.replace(">=0.1,<1", ">=99.0");
|
||||
.replace(">=3.0.0-beta.1,<4.0.0", ">=99.0");
|
||||
let incompatible_manifest = dir.path().join("incompatible.json");
|
||||
std::fs::write(&incompatible_manifest, incompatible).unwrap();
|
||||
let output = cli(
|
||||
@@ -364,8 +364,8 @@ fn protocol_negotiation_accepts_declared_versions_and_rejects_disjoint_ones() {
|
||||
"#!/bin/sh\nprintf 'analysis=%s\\ntrace=%s\\n' \"$MARQDO_PROTOCOL_ANALYSIS\" \"$MARQDO_PROTOCOL_TRACE\"\n",
|
||||
);
|
||||
let text = std::fs::read_to_string(&manifest).unwrap().replace(
|
||||
"\"marqdo\":\">=0.1,<1\"",
|
||||
"\"marqdo\":\">=0.1,<1\",\"analysis\":[2],\"trace\":[2]",
|
||||
"\"marqdo\":\">=3.0.0-beta.1,<4.0.0\"",
|
||||
"\"marqdo\":\">=3.0.0-beta.1,<4.0.0\",\"analysis\":[2],\"trace\":[2]",
|
||||
);
|
||||
std::fs::write(&manifest, text).unwrap();
|
||||
let install = cli(&home, &["tool", "install", manifest.to_str().unwrap()]);
|
||||
@@ -384,8 +384,8 @@ fn protocol_negotiation_accepts_declared_versions_and_rejects_disjoint_ones() {
|
||||
let command = format!("bad-{tag}");
|
||||
let manifest = write_tool(dir.path(), &command, "#!/bin/sh\nexit 0\n");
|
||||
let text = std::fs::read_to_string(&manifest).unwrap().replace(
|
||||
"\"marqdo\":\">=0.1,<1\"",
|
||||
&format!("\"marqdo\":\">=0.1,<1\",{compat}"),
|
||||
"\"marqdo\":\">=3.0.0-beta.1,<4.0.0\"",
|
||||
&format!("\"marqdo\":\">=3.0.0-beta.1,<4.0.0\",{compat}"),
|
||||
);
|
||||
std::fs::write(&manifest, text).unwrap();
|
||||
let output = cli(&home, &["tool", "install", manifest.to_str().unwrap()]);
|
||||
@@ -449,3 +449,37 @@ fn a_root_record_json_in_the_source_package_is_rejected() {
|
||||
assert_eq!(output.status.code(), Some(1));
|
||||
assert!(stderr(&output).contains("must not contain a root record.json"));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn beta_core_requires_an_explicit_prerelease_compatible_range() {
|
||||
let dir = TempDir::new("prerelease-range");
|
||||
let home = dir.path().join("home");
|
||||
let core = env!("CARGO_PKG_VERSION");
|
||||
|
||||
// The shipped example range opt-in must install on this real core.
|
||||
let manifest = write_tool(dir.path(), "prerelease", "#!/bin/sh\nexit 0\n");
|
||||
let install = cli(&home, &["tool", "install", manifest.to_str().unwrap()]);
|
||||
assert_eq!(install.status.code(), Some(0), "{}", stderr(&install));
|
||||
|
||||
if core.contains('-') {
|
||||
// SemVer: a stable-only requirement must not silently accept a
|
||||
// prerelease core. The operator has to opt in with a prerelease range.
|
||||
let manifest = write_tool(dir.path(), "stableonly", "#!/bin/sh\nexit 0\n");
|
||||
let text = std::fs::read_to_string(&manifest)
|
||||
.unwrap()
|
||||
.replace(">=3.0.0-beta.1,<4.0.0", ">=3.0.0,<4.0.0");
|
||||
std::fs::write(&manifest, text).unwrap();
|
||||
let output = cli(&home, &["tool", "install", manifest.to_str().unwrap()]);
|
||||
assert_eq!(
|
||||
output.status.code(),
|
||||
Some(1),
|
||||
"a stable-only range must reject prerelease core {core}: {}",
|
||||
stderr(&output)
|
||||
);
|
||||
assert!(
|
||||
stderr(&output).contains("requires marqdo"),
|
||||
"{}",
|
||||
stderr(&output)
|
||||
);
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user