handoff-mcp-server 0.7.1 → 0.7.3

package/Cargo.lock

@@ -144,7 +144,7 @@ dependencies = [
 
 [[package]]
 name = "handoff-mcp"
-version = "0.7.1"
+version = "0.7.3"
 dependencies = [
  "anyhow",
  "chrono",

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "handoff-mcp"
-version = "0.7.1"
+version = "0.7.3"
 edition = "2021"
 description = "MCP server that gives AI coding agents persistent memory across sessions"
 license = "MIT"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handoff-mcp-server",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "MCP server that gives AI coding agents persistent memory across sessions",
   "license": "MIT",
   "author": "AlphaElements <66808803+alphaelements@users.noreply.github.com>",
@@ -24,10 +24,9 @@
     "postinstall": "node scripts/postinstall.js"
   },
   "files": [
-    "bin/",
+    "bin/handoff-mcp.js",
     "scripts/",
     "src/",
-    "tests/",
     "Cargo.toml",
     "Cargo.lock",
     "LICENSE",

package/scripts/postinstall.js

@@ -10,7 +10,13 @@ const BIN_DIR = path.join(ROOT, "bin");
 const BINARY = path.join(BIN_DIR, "handoff-mcp-bin");
 
 if (fs.existsSync(BINARY)) {
-  process.exit(0);
+  try {
+    execSync(`"${BINARY}" --help`, { stdio: "ignore", timeout: 5000 });
+    process.exit(0);
+  } catch {
+    // prebuilt binary exists but can't run on this platform — rebuild
+    fs.unlinkSync(BINARY);
+  }
 }
 
 try {

package/src/mcp/handlers/import_context.rs

@@ -7,8 +7,7 @@ use crate::storage::config::read_config;
 use crate::storage::ensure_handoff_exists;
 use crate::storage::git::capture_git_state;
 use crate::storage::sessions::{
-    close_active_sessions, close_open_sessions, enforce_history_limit, write_open_session,
-    SessionData,
+    close_active_sessions, enforce_history_limit, write_open_session, SessionData,
 };
 use crate::storage::tasks::*;
 
@@ -60,7 +59,6 @@ pub fn handle(arguments: &Value) -> Result<String> {
             })?;
 
         close_active_sessions(&sessions_dir)?;
-        let closed = close_open_sessions(&sessions_dir)?;
         let git_state = capture_git_state(&project_dir)?;
         let now = Utc::now().to_rfc3339();
 
@@ -117,12 +115,10 @@ pub fn handle(arguments: &Value) -> Result<String> {
         };
         enforce_history_limit(&sessions_dir, history_limit)?;
 
-        let _ = closed;
         session_saved = true;
     } else if let Some(raw_notes) = arguments.get("raw_notes").and_then(|v| v.as_str()) {
         if !raw_notes.is_empty() {
             close_active_sessions(&sessions_dir)?;
-            let closed = close_open_sessions(&sessions_dir)?;
             let git_state = capture_git_state(&project_dir)?;
             let now = Utc::now().to_rfc3339();
 
@@ -162,7 +158,6 @@ pub fn handle(arguments: &Value) -> Result<String> {
             };
             enforce_history_limit(&sessions_dir, history_limit)?;
 
-            let _ = closed;
             session_saved = true;
         }
     }

package/src/mcp/handlers/save_context.rs

@@ -9,9 +9,9 @@ use crate::storage::config::read_config;
 use crate::storage::ensure_handoff_exists;
 use crate::storage::git::capture_git_state;
 use crate::storage::sessions::{
-    close_active_sessions, close_open_sessions, close_session_by_id, enforce_history_limit,
-    generate_session_id, pause_active_sessions, pause_session_by_id, read_active_sessions,
-    write_open_session, SessionData,
+    close_active_sessions, close_session_by_id, enforce_history_limit, generate_session_id,
+    pause_active_sessions, pause_session_by_id, read_active_sessions, write_session_with_status,
+    SessionData,
 };
 
 pub fn handle(arguments: &Value) -> Result<String> {
@@ -32,6 +32,17 @@ pub fn handle(arguments: &Value) -> Result<String> {
         .get("pause_active")
         .and_then(|v| v.as_bool())
         .unwrap_or(false);
+    let session_status = arguments
+        .get("session_status")
+        .and_then(|v| v.as_str())
+        .unwrap_or("open");
+
+    if session_status != "open" && session_status != "active" {
+        anyhow::bail!(
+            "Invalid session_status '{}': must be 'open' or 'active'",
+            session_status
+        );
+    }
 
     let mut total_paused = 0usize;
     if let Some(id) = pause_id {
@@ -50,8 +61,7 @@ pub fn handle(arguments: &Value) -> Result<String> {
             0
         }
     } else if pause_id.is_some() || pause_all {
-        let closed_open = close_open_sessions(&sessions_dir)?;
-        closed_open.len()
+        0
     } else {
         let active = read_active_sessions(&sessions_dir)?;
         if active.len() > 1 {
@@ -64,8 +74,7 @@ pub fn handle(arguments: &Value) -> Result<String> {
             );
         }
         let closed_active = close_active_sessions(&sessions_dir)?;
-        let closed_open = close_open_sessions(&sessions_dir)?;
-        closed_active.len() + closed_open.len()
+        closed_active.len()
     };
 
     let git_state = capture_git_state(&project_dir)?;
@@ -89,7 +98,7 @@ pub fn handle(arguments: &Value) -> Result<String> {
         environment: arguments.get("environment").cloned(),
     };
 
-    let path = write_open_session(&sessions_dir, &data)?;
+    let path = write_session_with_status(&sessions_dir, &data, session_status)?;
 
     let history_limit = if config_path.exists() {
         read_config(&config_path)

package/src/mcp/tools.rs

@@ -57,9 +57,15 @@ pub fn all_tool_definitions() -> Vec<ToolDefinition> {
                         "type": "string",
                         "description": "One-line summary of this session"
                     },
+                    "session_status": {
+                        "type": "string",
+                        "description": "Status of the new session: 'open' (default) = saved but not activated, allows multiple open sessions; 'active' = immediately active for this session.",
+                        "enum": ["open", "active"],
+                        "default": "open"
+                    },
                     "close_session_id": {
                         "type": "string",
-                        "description": "Session ID to close. If omitted (and no pause options set), all active and open sessions are closed."
+                        "description": "Session ID to close. If omitted (and no pause options set), active sessions are closed."
                     },
                     "pause_session_id": {
                         "type": "string",

package/src/storage/sessions.rs

@@ -321,8 +321,24 @@ pub fn enforce_history_limit(sessions_dir: &Path, limit: u32) -> Result<u32> {
     Ok(removed)
 }
 
-// Backward-compatible aliases for tests and migration
-#[doc(hidden)]
-pub fn write_active_session(sessions_dir: &Path, data: &SessionData) -> Result<PathBuf> {
-    write_open_session(sessions_dir, data)
+pub fn write_session_with_status(
+    sessions_dir: &Path,
+    data: &SessionData,
+    status: &str,
+) -> Result<PathBuf> {
+    let mut data = data.clone();
+    if data.id.is_none() {
+        data.id = Some(generate_session_id());
+    }
+
+    let ts_part = compact_timestamp(&data);
+    let base = generate_session_filename(&data.summary, &ts_part);
+    let filename = format!("{base}.{status}.json");
+    let path = sessions_dir.join(&filename);
+
+    let content = serde_json::to_string_pretty(&data).context("Failed to serialize session")?;
+    std::fs::write(&path, content)
+        .with_context(|| format!("Failed to write session: {}", path.display()))?;
+
+    Ok(path)
 }

package/tests/mcp_protocol.rs

@@ -1,208 +0,0 @@
-use serde_json::{json, Value};
-
-fn send(input: &str) -> Option<Value> {
-    let result = handoff_mcp::mcp::protocol::process_line(input)?;
-    Some(serde_json::from_str(&result).expect("response should be valid JSON"))
-}
-
-#[test]
-fn initialize_returns_capabilities() {
-    let resp = send(
-        r#"{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"0.1.0"}}}"#,
-    )
-    .expect("initialize should return a response");
-
-    assert_eq!(resp["jsonrpc"], "2.0");
-    assert_eq!(resp["id"], 1);
-    assert!(resp["error"].is_null());
-
-    let result = &resp["result"];
-    assert_eq!(result["protocolVersion"], "2025-03-26");
-    assert!(result["capabilities"]["tools"].is_object());
-    assert!(result["capabilities"]["resources"].is_object());
-    assert_eq!(result["serverInfo"]["name"], "handoff-mcp");
-    assert!(result["serverInfo"]["version"].is_string());
-    assert!(result["instructions"].is_string());
-}
-
-#[test]
-fn initialized_notification_returns_nothing() {
-    let resp = send(r#"{"jsonrpc":"2.0","method":"notifications/initialized"}"#);
-    assert!(
-        resp.is_none(),
-        "notifications should not produce a response"
-    );
-}
-
-#[test]
-fn tools_list_returns_all_tools() {
-    let resp = send(r#"{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}"#)
-        .expect("tools/list should return a response");
-
-    assert_eq!(resp["id"], 2);
-    assert!(resp["error"].is_null());
-
-    let tools = resp["result"]["tools"]
-        .as_array()
-        .expect("tools should be an array");
-
-    let expected_names = [
-        "handoff_init",
-        "handoff_load_context",
-        "handoff_save_context",
-        "handoff_list_tasks",
-        "handoff_update_task",
-        "handoff_get_config",
-        "handoff_update_config",
-        "handoff_dashboard",
-        "handoff_import_context",
-        "handoff_refer",
-        "handoff_list_referrals",
-        "handoff_update_referral",
-    ];
-
-    let tool_names: Vec<&str> = tools
-        .iter()
-        .map(|t| t["name"].as_str().expect("tool name should be a string"))
-        .collect();
-
-    for expected in &expected_names {
-        assert!(tool_names.contains(expected), "missing tool: {expected}");
-    }
-
-    for tool in tools {
-        assert!(
-            tool["description"].is_string(),
-            "tool should have description"
-        );
-        assert!(
-            tool["inputSchema"].is_object(),
-            "tool should have inputSchema"
-        );
-    }
-}
-
-#[test]
-fn resources_list_returns_resources() {
-    let resp = send(r#"{"jsonrpc":"2.0","id":3,"method":"resources/list","params":{}}"#)
-        .expect("resources/list should return a response");
-
-    assert_eq!(resp["id"], 3);
-    assert!(resp["error"].is_null());
-
-    let resources = resp["result"]["resources"]
-        .as_array()
-        .expect("resources should be an array");
-
-    assert_eq!(resources.len(), 2);
-
-    let uris: Vec<&str> = resources
-        .iter()
-        .map(|r| r["uri"].as_str().expect("resource uri"))
-        .collect();
-
-    assert!(uris.contains(&"handoff://sessions"));
-    assert!(uris.contains(&"handoff://config"));
-}
-
-#[test]
-fn invalid_json_returns_parse_error() {
-    let resp = send("not valid json at all").expect("should return error response");
-
-    assert_eq!(resp["jsonrpc"], "2.0");
-    assert!(resp["id"].is_null());
-
-    let error = &resp["error"];
-    assert_eq!(error["code"], -32700);
-    assert!(error["message"].as_str().unwrap().contains("Parse error"));
-}
-
-#[test]
-fn unknown_method_returns_method_not_found() {
-    let resp = send(r#"{"jsonrpc":"2.0","id":99,"method":"nonexistent/method","params":{}}"#)
-        .expect("should return error response");
-
-    assert_eq!(resp["id"], 99);
-
-    let error = &resp["error"];
-    assert_eq!(error["code"], -32601);
-    assert!(error["message"]
-        .as_str()
-        .unwrap()
-        .contains("Method not found"));
-}
-
-#[test]
-fn invalid_jsonrpc_version_returns_error() {
-    let resp = send(r#"{"jsonrpc":"1.0","id":5,"method":"initialize","params":{}}"#)
-        .expect("should return error response");
-
-    assert_eq!(resp["id"], 5);
-    let error = &resp["error"];
-    assert_eq!(error["code"], -32600);
-}
-
-#[test]
-fn empty_line_returns_none() {
-    assert!(send("").is_none());
-    assert!(send("   ").is_none());
-}
-
-#[test]
-fn request_id_is_preserved() {
-    let resp_str = send(r#"{"jsonrpc":"2.0","id":"abc-123","method":"tools/list","params":{}}"#)
-        .expect("should return response");
-    assert_eq!(resp_str["id"], "abc-123");
-
-    let resp_num = send(r#"{"jsonrpc":"2.0","id":42,"method":"tools/list","params":{}}"#)
-        .expect("should return response");
-    assert_eq!(resp_num["id"], 42);
-}
-
-#[test]
-fn tools_have_valid_input_schemas() {
-    let resp = send(r#"{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}"#)
-        .expect("tools/list response");
-
-    let tools = resp["result"]["tools"].as_array().unwrap();
-    for tool in tools {
-        let schema = &tool["inputSchema"];
-        assert_eq!(
-            schema["type"], "object",
-            "inputSchema for {} should have type: object",
-            tool["name"]
-        );
-    }
-}
-
-#[test]
-fn multiple_requests_in_sequence() {
-    let r1 = send(r#"{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}"#).unwrap();
-    assert!(r1["result"].is_object());
-
-    send(r#"{"jsonrpc":"2.0","method":"notifications/initialized"}"#);
-
-    let r2 = send(r#"{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}"#).unwrap();
-    assert!(r2["result"]["tools"].is_array());
-
-    let r3 = send(r#"{"jsonrpc":"2.0","id":3,"method":"resources/list","params":{}}"#).unwrap();
-    assert!(r3["result"]["resources"].is_array());
-}
-
-#[test]
-fn e2e_json_roundtrip() {
-    let input = json!({
-        "jsonrpc": "2.0",
-        "id": 1,
-        "method": "initialize",
-        "params": {
-            "protocolVersion": "2025-03-26",
-            "capabilities": {},
-            "clientInfo": { "name": "test-client", "version": "1.0" }
-        }
-    });
-
-    let resp = send(&input.to_string()).unwrap();
-    assert_eq!(resp["result"]["protocolVersion"], "2025-03-26");
-    assert_eq!(resp["result"]["serverInfo"]["name"], "handoff-mcp");
-}

package/tests/storage_config.rs

@@ -1,107 +0,0 @@
-use handoff_mcp::storage::config::{read_config, write_config, Config};
-use std::fs;
-use tempfile::TempDir;
-
-fn setup() -> TempDir {
-    tempfile::tempdir().expect("failed to create temp dir")
-}
-
-#[test]
-fn write_and_read_config() {
-    let dir = setup();
-    let path = dir.path().join("config.toml");
-
-    let config = Config::new("test-project", "A test project");
-    write_config(&path, &config).unwrap();
-
-    let read_back = read_config(&path).unwrap();
-    assert_eq!(read_back.project.name, "test-project");
-    assert_eq!(
-        read_back.project.description.as_deref(),
-        Some("A test project")
-    );
-}
-
-#[test]
-fn config_has_correct_defaults() {
-    let dir = setup();
-    let path = dir.path().join("config.toml");
-
-    let config = Config::new("proj", "");
-    write_config(&path, &config).unwrap();
-
-    let read_back = read_config(&path).unwrap();
-    assert_eq!(read_back.settings.history_limit, 20);
-    assert_eq!(read_back.settings.done_task_limit, 10);
-    assert!(read_back.settings.auto_git_summary);
-    assert!(read_back.settings.context_files.is_empty());
-    assert_eq!(read_back.dashboard.scan_dirs, vec!["~/pro/"]);
-    assert!(read_back.dashboard.exclude_patterns.is_empty());
-    assert!(read_back.project.description.is_none());
-}
-
-#[test]
-fn config_with_custom_values() {
-    let dir = setup();
-    let path = dir.path().join("config.toml");
-
-    let toml_content = r#"
-[project]
-name = "custom-proj"
-description = "Custom"
-
-[settings]
-history_limit = 50
-done_task_limit = 5
-auto_git_summary = false
-context_files = ["README.md", "CLAUDE.md"]
-
-[dashboard]
-scan_dirs = ["~/work/", "~/projects/"]
-exclude_patterns = ["*/target", "*/node_modules"]
-"#;
-    fs::write(&path, toml_content).unwrap();
-
-    let config = read_config(&path).unwrap();
-    assert_eq!(config.project.name, "custom-proj");
-    assert_eq!(config.settings.history_limit, 50);
-    assert_eq!(config.settings.done_task_limit, 5);
-    assert!(!config.settings.auto_git_summary);
-    assert_eq!(config.settings.context_files.len(), 2);
-    assert_eq!(config.dashboard.scan_dirs.len(), 2);
-    assert_eq!(config.dashboard.exclude_patterns.len(), 2);
-}
-
-#[test]
-fn config_missing_file_returns_error() {
-    let dir = setup();
-    let path = dir.path().join("nonexistent.toml");
-    assert!(read_config(&path).is_err());
-}
-
-#[test]
-fn config_invalid_toml_returns_error() {
-    let dir = setup();
-    let path = dir.path().join("bad.toml");
-    fs::write(&path, "this is not valid toml [[[").unwrap();
-    assert!(read_config(&path).is_err());
-}
-
-#[test]
-fn config_partial_toml_uses_defaults() {
-    let dir = setup();
-    let path = dir.path().join("config.toml");
-    fs::write(
-        &path,
-        r#"
-[project]
-name = "minimal"
-"#,
-    )
-    .unwrap();
-
-    let config = read_config(&path).unwrap();
-    assert_eq!(config.project.name, "minimal");
-    assert_eq!(config.settings.history_limit, 20);
-    assert_eq!(config.dashboard.scan_dirs, vec!["~/pro/"]);
-}