- add tool install/list/remove and unknown-command dispatch without hardcoded tool names or clap variants - validate and copy local tool packages atomically, reject entrypoint escapes and symlinks, record and re-verify SHA-256 - forward OsString args, stdio, cwd and exit status without a shell; never execute PATH programs implicitly - add black-box tests for arbitrary names, Unicode args, built-in conflicts, traversal, version mismatch, tampering and PATH hijacking - add ADR-0013 and mark R3 complete
185 lines
6.2 KiB
Rust
185 lines
6.2 KiB
Rust
//! External CLI Tool Protocol v1 black-box tests (spec/tool-v1.md).
|
|
#![cfg(unix)]
|
|
|
|
use std::path::{Path, PathBuf};
|
|
use std::process::{Command, Output};
|
|
use std::sync::atomic::{AtomicU32, Ordering};
|
|
|
|
static COUNTER: AtomicU32 = AtomicU32::new(0);
|
|
|
|
struct TempDir(PathBuf);
|
|
|
|
impl TempDir {
|
|
fn new(tag: &str) -> Self {
|
|
let id = COUNTER.fetch_add(1, Ordering::Relaxed);
|
|
let path = std::env::temp_dir().join(format!(
|
|
"marqdo-tool-test-{}-{id}-{tag}",
|
|
std::process::id()
|
|
));
|
|
std::fs::create_dir_all(&path).unwrap();
|
|
Self(path)
|
|
}
|
|
|
|
fn path(&self) -> &Path {
|
|
&self.0
|
|
}
|
|
}
|
|
|
|
impl Drop for TempDir {
|
|
fn drop(&mut self) {
|
|
let _ = std::fs::remove_dir_all(&self.0);
|
|
}
|
|
}
|
|
|
|
fn binary() -> &'static str {
|
|
env!("CARGO_BIN_EXE_marqdo")
|
|
}
|
|
|
|
fn cli(home: &Path, args: &[&str]) -> Output {
|
|
Command::new(binary())
|
|
.args(args)
|
|
.env("MARQDO_TOOL_HOME", home)
|
|
.output()
|
|
.expect("run marqdo")
|
|
}
|
|
|
|
fn write_tool(dir: &Path, command: &str, script: &str) -> PathBuf {
|
|
let package = dir.join(format!("{command}-pkg"));
|
|
std::fs::create_dir_all(package.join("bin")).unwrap();
|
|
let entry = package.join("bin").join(command);
|
|
std::fs::write(&entry, script).unwrap();
|
|
#[cfg(unix)]
|
|
{
|
|
use std::os::unix::fs::PermissionsExt;
|
|
let mut permissions = std::fs::metadata(&entry).unwrap().permissions();
|
|
permissions.set_mode(0o755);
|
|
std::fs::set_permissions(&entry, permissions).unwrap();
|
|
}
|
|
let manifest = package.join("tool.json");
|
|
std::fs::write(
|
|
&manifest,
|
|
format!(
|
|
r#"{{"schema":"marqdo.cli-tool","schema_version":1,"name":"demo.{command}","version":"0.1.0","command":"{command}","entrypoint":"bin/{command}","compatibility":{{"marqdo":">=0.1,<1"}}}}"#
|
|
),
|
|
)
|
|
.unwrap();
|
|
manifest
|
|
}
|
|
|
|
fn stderr(output: &Output) -> String {
|
|
String::from_utf8_lossy(&output.stderr).to_string()
|
|
}
|
|
|
|
fn stdout(output: &Output) -> String {
|
|
String::from_utf8_lossy(&output.stdout).to_string()
|
|
}
|
|
|
|
#[test]
|
|
fn install_dispatch_list_remove_without_core_knowledge_of_the_name() {
|
|
let dir = TempDir::new("roundtrip");
|
|
let home = dir.path().join("home");
|
|
let manifest = write_tool(
|
|
dir.path(),
|
|
"benchmark",
|
|
"#!/bin/sh\nfor a in \"$@\"; do printf 'arg=%s\\n' \"$a\"; done\nprintf 'protocol=%s\\n' \"$MARQDO_TOOL_PROTOCOL\"\nexit 7\n",
|
|
);
|
|
|
|
let install = cli(&home, &["tool", "install", manifest.to_str().unwrap()]);
|
|
assert_eq!(install.status.code(), Some(0), "{}", stderr(&install));
|
|
|
|
let listed = cli(&home, &["tool", "list"]);
|
|
assert!(stdout(&listed).contains("benchmark 0.1.0"));
|
|
|
|
let output = cli(&home, &["benchmark", "run", ".", "空格"]);
|
|
assert_eq!(output.status.code(), Some(7));
|
|
let text = stdout(&output);
|
|
assert!(text.contains("arg=run"));
|
|
assert!(text.contains("arg=."));
|
|
assert!(text.contains("arg=空格"));
|
|
assert!(text.contains("protocol=1"));
|
|
|
|
let removed = cli(&home, &["tool", "remove", "benchmark"]);
|
|
assert_eq!(removed.status.code(), Some(0));
|
|
let unknown = cli(&home, &["benchmark"]);
|
|
assert_eq!(unknown.status.code(), Some(2));
|
|
assert!(stderr(&unknown).contains("unknown command"));
|
|
}
|
|
|
|
#[test]
|
|
fn invalid_manifests_and_path_escapes_are_rejected() {
|
|
let dir = TempDir::new("invalid");
|
|
let home = dir.path().join("home");
|
|
let manifest = write_tool(dir.path(), "lintx", "#!/bin/sh\nexit 0\n");
|
|
|
|
let builtin = std::fs::read_to_string(&manifest)
|
|
.unwrap()
|
|
.replace("\"command\":\"lintx\"", "\"command\":\"run\"");
|
|
let builtin_manifest = dir.path().join("builtin.json");
|
|
std::fs::write(&builtin_manifest, builtin).unwrap();
|
|
let output = cli(
|
|
&home,
|
|
&["tool", "install", builtin_manifest.to_str().unwrap()],
|
|
);
|
|
assert_eq!(output.status.code(), Some(1));
|
|
assert!(stderr(&output).contains("built-in"));
|
|
|
|
let traversal = std::fs::read_to_string(&manifest)
|
|
.unwrap()
|
|
.replace("bin/lintx", "../outside");
|
|
let traversal_manifest = dir.path().join("traversal.json");
|
|
std::fs::write(&traversal_manifest, traversal).unwrap();
|
|
let output = cli(
|
|
&home,
|
|
&["tool", "install", traversal_manifest.to_str().unwrap()],
|
|
);
|
|
assert_eq!(output.status.code(), Some(1));
|
|
|
|
let incompatible = std::fs::read_to_string(&manifest)
|
|
.unwrap()
|
|
.replace(">=0.1,<1", ">=99.0");
|
|
let incompatible_manifest = dir.path().join("incompatible.json");
|
|
std::fs::write(&incompatible_manifest, incompatible).unwrap();
|
|
let output = cli(
|
|
&home,
|
|
&["tool", "install", incompatible_manifest.to_str().unwrap()],
|
|
);
|
|
assert_eq!(output.status.code(), Some(1));
|
|
assert!(stderr(&output).contains("requires marqdo"));
|
|
}
|
|
|
|
#[test]
|
|
fn tampered_binary_and_path_hijack_are_not_executed() {
|
|
let dir = TempDir::new("security");
|
|
let home = dir.path().join("home");
|
|
let manifest = write_tool(dir.path(), "custom-abc", "#!/bin/sh\nexit 0\n");
|
|
assert_eq!(
|
|
cli(&home, &["tool", "install", manifest.to_str().unwrap()])
|
|
.status
|
|
.code(),
|
|
Some(0)
|
|
);
|
|
let installed = home.join("custom-abc").join("bin").join("custom-abc");
|
|
std::fs::write(&installed, "#!/bin/sh\nexit 99\n").unwrap();
|
|
let tampered = cli(&home, &["custom-abc"]);
|
|
assert_eq!(tampered.status.code(), Some(1));
|
|
assert!(stderr(&tampered).contains("hash mismatch"));
|
|
|
|
// A PATH program with the marqdo prefix is not implicitly a tool.
|
|
let path_dir = dir.path().join("path");
|
|
std::fs::create_dir_all(&path_dir).unwrap();
|
|
let hijack = path_dir.join("marqdo-hijack");
|
|
std::fs::write(&hijack, "#!/bin/sh\nexit 42\n").unwrap();
|
|
use std::os::unix::fs::PermissionsExt;
|
|
let mut permissions = std::fs::metadata(&hijack).unwrap().permissions();
|
|
permissions.set_mode(0o755);
|
|
std::fs::set_permissions(&hijack, permissions).unwrap();
|
|
let output = Command::new(binary())
|
|
.arg("hijack")
|
|
.env("MARQDO_TOOL_HOME", &home)
|
|
.env("PATH", &path_dir)
|
|
.output()
|
|
.unwrap();
|
|
assert_eq!(output.status.code(), Some(2));
|
|
assert!(stderr(&output).contains("unknown command"));
|
|
}
|