feat: add integration tests for CLI commands and packaging

Author: TrueNine

cli/Cargo.toml

@@ -12,7 +12,18 @@ repository.workspace = true
 name = "tnmsc"
 path = "src/main.rs"
 
+[[test]]
+name = "command_contract"
+path = "integration-tests/command_contract.rs"
+
+[[test]]
+name = "packaging_smoke"
+path = "integration-tests/packaging_smoke.rs"
+
 [dependencies]
 tnmsc = { workspace = true }
 clap = { workspace = true }
 serde_json = { workspace = true }
+
+[dev-dependencies]
+testcontainers = { version = "0.27.3", features = ["blocking"] }

cli/integration-tests/command_contract.rs

@@ -0,0 +1,96 @@
+mod support;
+
+use std::fs;
+
+use support::{current_package_version, not_implemented_message, run_tnmsc, TestDir};
+
+#[test]
+fn help_lists_supported_commands() {
+  let result = run_tnmsc(&["help"], &support::workspace_root());
+  result.assert_success("tnmsc help");
+
+  for expected in ["install", "dry-run", "clean", "plugins", "version", "help"] {
+    assert!(
+      result.stdout.contains(expected),
+      "help output should include `{expected}`.\nstdout:\n{}",
+      result.stdout
+    );
+  }
+}
+
+#[test]
+fn version_matches_workspace_version() {
+  let result = run_tnmsc(&["version"], &support::workspace_root());
+  result.assert_success("tnmsc version");
+
+  assert_eq!(result.stdout.trim(), current_package_version());
+}
+
+#[test]
+fn plugins_lists_core_output_adaptors() {
+  let result = run_tnmsc(&["plugins"], &support::workspace_root());
+  result.assert_success("tnmsc plugins");
+
+  for expected in [
+    "CodexCLIOutputAdaptor",
+    "ClaudeCodeCLIOutputAdaptor",
+    "TraeOutputAdaptor",
+    "OpencodeCLIOutputAdaptor",
+  ] {
+    assert!(
+      result.stdout.contains(expected),
+      "plugins output should include `{expected}`.\nstdout:\n{}",
+      result.stdout
+    );
+  }
+}
+
+#[test]
+fn schema_output_writes_valid_json_in_integration_sandbox() {
+  let temp_dir = TestDir::new("tnmsc-schema-contract");
+  let schema_path = temp_dir.path().join("tnmsc.schema.json");
+  let schema_path_arg = schema_path.to_string_lossy().into_owned();
+
+  let result = run_tnmsc(
+    &["schema", "--output", &schema_path_arg],
+    &support::workspace_root(),
+  );
+  result.assert_success("tnmsc schema --output");
+
+  let content = fs::read_to_string(&schema_path)
+    .unwrap_or_else(|error| panic!("failed to read {}: {error}", schema_path.display()));
+  let parsed: serde_json::Value = serde_json::from_str(&content)
+    .unwrap_or_else(|error| panic!("schema output should be valid JSON: {error}"));
+
+  let object = parsed
+    .as_object()
+    .expect("schema output should be a top-level JSON object");
+
+  assert!(object.contains_key("$schema"));
+  assert!(object.contains_key("properties"));
+}
+
+#[test]
+fn install_like_commands_fail_with_not_implemented_contract() {
+  for (args, command_name, display) in [
+    (&[][..], "install", "tnmsc"),
+    (&["install"][..], "install", "tnmsc install"),
+    (&["dry-run"][..], "dry-run", "tnmsc dry-run"),
+    (&["clean"][..], "clean", "tnmsc clean"),
+    (
+      &["clean", "--dry-run"][..],
+      "clean",
+      "tnmsc clean --dry-run",
+    ),
+  ] {
+    let result = run_tnmsc(args, &support::workspace_root());
+    result.assert_failure(display);
+
+    let expected = not_implemented_message(command_name);
+    assert!(
+      result.stderr.contains(&expected),
+      "{display} stderr should contain the not-implemented contract.\nexpected:\n{expected}\nactual:\n{}",
+      result.stderr
+    );
+  }
+}

cli/integration-tests/packaging_smoke.rs

@@ -0,0 +1,98 @@
+mod support;
+
+use std::fs;
+
+#[cfg(unix)]
+use std::os::unix::fs::PermissionsExt;
+
+use support::{pack_cli_artifacts, quote_shell, TestContainer};
+
+#[test]
+fn packaging_smoke_covers_release_binary_and_global_install() {
+  if !support::is_linux_x64_host() {
+    eprintln!("skipping packaging smoke on unsupported host");
+    return;
+  }
+
+  let staged = support::create_staged_package_root();
+  let package_root = staged.package_root.to_string_lossy().into_owned();
+  let workspace_root = support::workspace_root().to_string_lossy().into_owned();
+
+  let assemble = support::run_tnmsc_with_env(
+    &["assemble-npm", "--profile", "release"],
+    &support::cli_manifest_dir(),
+    &[
+      ("TNMSC_NPM_PACKAGE_ROOT", package_root.as_str()),
+      ("TNMSC_WORKSPACE_ROOT", workspace_root.as_str()),
+    ],
+  );
+  assemble.assert_success("tnmsc assemble-npm --profile release");
+
+  assert!(
+    staged.linux_binary.is_file(),
+    "expected hydrated linux binary at {}",
+    staged.linux_binary.display()
+  );
+
+  #[cfg(unix)]
+  {
+    let mode = fs::metadata(&staged.linux_binary)
+      .unwrap_or_else(|error| panic!("failed to stat {}: {error}", staged.linux_binary.display()))
+      .permissions()
+      .mode();
+    assert!(
+      mode & 0o111 != 0,
+      "expected {} to be executable, mode was {:o}",
+      staged.linux_binary.display(),
+      mode
+    );
+  }
+
+  let artifacts = pack_cli_artifacts();
+  let container = TestContainer::start(&artifacts);
+
+  let install_command = format!(
+    "corepack enable && corepack prepare pnpm@{} --activate && pnpm add -g {} {}",
+    quote_shell(support::pnpm_version()),
+    quote_shell("/artifacts/cli.tgz"),
+    quote_shell("/artifacts/linux-x64-gnu.tgz")
+  );
+  container.exec_success(&install_command);
+
+  let help = container.exec("tnmsc help");
+  help.assert_success("global tnmsc help");
+  for expected in ["install", "dry-run", "clean", "plugins"] {
+    assert!(
+      help.stdout.contains(expected),
+      "global help output should include `{expected}`.\nstdout:\n{}",
+      help.stdout
+    );
+  }
+
+  let plugins = container.exec("tnmsc plugins");
+  plugins.assert_success("global tnmsc plugins");
+  for expected in [
+    "CodexCLIOutputAdaptor",
+    "ClaudeCodeCLIOutputAdaptor",
+    "TraeOutputAdaptor",
+    "OpencodeCLIOutputAdaptor",
+  ] {
+    assert!(
+      plugins.stdout.contains(expected),
+      "global plugins output should include `{expected}`.\nstdout:\n{}",
+      plugins.stdout
+    );
+  }
+
+  container.exec_success(
+    r#"
+MAIN_PACKAGE_JSON="$(find -L /pnpm/global -path '*/@truenine/memory-sync-cli/package.json' -print -quit)"
+PLATFORM_PACKAGE_JSON="$(find -L /pnpm/global -path '*/@truenine/memory-sync-cli-linux-x64-gnu/package.json' -print -quit)"
+test -n "$MAIN_PACKAGE_JSON"
+test -n "$PLATFORM_PACKAGE_JSON"
+test -x "$(dirname "$PLATFORM_PACKAGE_JSON")/bin/tnmsc"
+test -x "$(command -v tnmsc)"
+test ! -e "$(dirname "$MAIN_PACKAGE_JSON")/dist/index.mjs"
+"#,
+  );
+}