handoff-mcp-server 0.7.3 → 0.8.0

package/Cargo.lock

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

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "handoff-mcp"
-version = "0.7.3"
+version = "0.8.0"
 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.3",
+  "version": "0.8.0",
   "description": "MCP server that gives AI coding agents persistent memory across sessions",
   "license": "MIT",
   "author": "AlphaElements <66808803+alphaelements@users.noreply.github.com>",

package/src/mcp/handlers/check_criterion.rs

@@ -28,8 +28,11 @@ pub fn handle(arguments: &Value) -> Result<String> {
         .and_then(|v| v.as_bool())
         .ok_or_else(|| anyhow::anyhow!("'checked' parameter is required (boolean)"))?;
 
-    let task_dir = find_task_dir_by_id(&tasks_dir, task_id)?
-        .ok_or_else(|| anyhow::anyhow!("Task not found: {task_id}"))?;
+    let task_dir = find_task_dir_by_id(&tasks_dir, task_id)?.ok_or_else(|| {
+        anyhow::anyhow!(
+            "Task not found: {task_id}. Use handoff_list_tasks to see available task IDs."
+        )
+    })?;
 
     let (mut data, status) = read_task(&task_dir)?
         .ok_or_else(|| anyhow::anyhow!("Task file not found in {}", task_dir.display()))?;

package/src/mcp/handlers/get_task.rs

@@ -16,8 +16,11 @@ pub fn handle(arguments: &Value) -> Result<String> {
         .and_then(|v| v.as_str())
         .ok_or_else(|| anyhow::anyhow!("'task_id' parameter is required"))?;
 
-    let task_dir = find_task_dir_by_id(&tasks_dir, task_id)?
-        .ok_or_else(|| anyhow::anyhow!("Task not found: {task_id}"))?;
+    let task_dir = find_task_dir_by_id(&tasks_dir, task_id)?.ok_or_else(|| {
+        anyhow::anyhow!(
+            "Task not found: {task_id}. Use handoff_list_tasks to see available task IDs."
+        )
+    })?;
 
     let (data, status) = read_task(&task_dir)?
         .ok_or_else(|| anyhow::anyhow!("Task file not found in {}", task_dir.display()))?;

package/src/mcp/handlers/update_task.rs

@@ -23,7 +23,11 @@ pub fn handle(arguments: &Value) -> Result<String> {
         if let Some(new_parent_id) = move_to {
             return handle_move(&tasks_dir, existing_id, new_parent_id);
         }
-        return handle_update(&tasks_dir, existing_id, task_val);
+        let task_exists = find_task_dir_by_id(&tasks_dir, existing_id)?.is_some();
+        if task_exists {
+            return handle_update(&tasks_dir, existing_id, task_val);
+        }
+        return handle_upsert_create(&tasks_dir, existing_id, task_val, arguments);
     }
 
     let title = task_val
@@ -106,6 +110,84 @@ fn handle_create(
     Ok(format!("Created task {new_id}: {title} [{status}]"))
 }
 
+fn handle_upsert_create(
+    tasks_dir: &std::path::Path,
+    task_id: &str,
+    task_val: &Value,
+    arguments: &Value,
+) -> Result<String> {
+    let title = task_val
+        .get("title")
+        .and_then(|v| v.as_str())
+        .ok_or_else(|| {
+            anyhow::anyhow!(
+                "Task '{task_id}' does not exist and cannot be created without a title. \
+                 Provide 'title' to create a new task with this ID, or use handoff_list_tasks to find existing task IDs."
+            )
+        })?;
+
+    let parent_id = arguments.get("parent_id").and_then(|v| v.as_str());
+
+    let parent_dir = match parent_id {
+        Some(pid) => find_task_dir_by_id(tasks_dir, pid)?.ok_or_else(|| {
+            anyhow::anyhow!(
+                "Parent task not found: {pid}. Use handoff_list_tasks to see available task IDs."
+            )
+        })?,
+        None => tasks_dir.to_path_buf(),
+    };
+
+    let slug = title_to_slug(title);
+    let dir_name = format!("{task_id}-{slug}");
+    let task_dir = parent_dir.join(&dir_name);
+    std::fs::create_dir_all(&task_dir)
+        .with_context(|| format!("Failed to create task dir: {}", task_dir.display()))?;
+
+    let now = Utc::now().to_rfc3339();
+    let status = task_val
+        .get("status")
+        .and_then(|v| v.as_str())
+        .unwrap_or("todo");
+
+    if !is_valid_status(status) {
+        anyhow::bail!("Invalid status: {status}");
+    }
+
+    let priority = task_val.get("priority").and_then(|v| v.as_str());
+    validate_priority(priority)?;
+
+    let dependencies = extract_string_array(task_val, "dependencies");
+    if !dependencies.is_empty() {
+        validate_dependencies(tasks_dir, task_id, &dependencies)?;
+    }
+
+    let data = TaskData {
+        id: task_id.to_string(),
+        title: title.to_string(),
+        notes: task_val
+            .get("notes")
+            .and_then(|v| v.as_str())
+            .map(String::from),
+        priority: priority.map(String::from),
+        created_at: Some(now.clone()),
+        updated_at: Some(now),
+        completed_at: None,
+        labels: extract_string_array(task_val, "labels"),
+        links: extract_string_array(task_val, "links"),
+        done_criteria: extract_done_criteria(task_val),
+        schedule: extract_schedule(task_val),
+        dependencies,
+        order: task_val
+            .get("order")
+            .and_then(|v| v.as_u64())
+            .map(|v| v as u32),
+    };
+
+    write_task(&task_dir, status, &data)?;
+
+    Ok(format!("Created task {task_id}: {title} [{status}]"))
+}
+
 fn handle_update(tasks_dir: &std::path::Path, task_id: &str, task_val: &Value) -> Result<String> {
     let task_dir = find_task_dir_by_id(tasks_dir, task_id)?
         .ok_or_else(|| anyhow::anyhow!("Task not found: {task_id}"))?;
@@ -179,11 +261,17 @@ fn handle_update(tasks_dir: &std::path::Path, task_id: &str, task_val: &Value) -
 }
 
 fn handle_move(tasks_dir: &std::path::Path, task_id: &str, new_parent_id: &str) -> Result<String> {
-    let task_dir = find_task_dir_by_id(tasks_dir, task_id)?
-        .ok_or_else(|| anyhow::anyhow!("Task not found: {task_id}"))?;
+    let task_dir = find_task_dir_by_id(tasks_dir, task_id)?.ok_or_else(|| {
+        anyhow::anyhow!(
+            "Task not found: {task_id}. Use handoff_list_tasks to see available task IDs."
+        )
+    })?;
 
-    let new_parent_dir = find_task_dir_by_id(tasks_dir, new_parent_id)?
-        .ok_or_else(|| anyhow::anyhow!("New parent task not found: {new_parent_id}"))?;
+    let new_parent_dir = find_task_dir_by_id(tasks_dir, new_parent_id)?.ok_or_else(|| {
+        anyhow::anyhow!(
+            "New parent task not found: {new_parent_id}. Use handoff_list_tasks to see available task IDs."
+        )
+    })?;
 
     let dir_name = task_dir
         .file_name()

package/src/mcp/tools.rs

@@ -244,7 +244,7 @@ pub fn all_tool_definitions() -> Vec<ToolDefinition> {
                     "task": {
                         "type": "object",
                         "properties": {
-                            "id": { "type": "string", "description": "Task ID. Omit for new task (auto-generated)." },
+                            "id": { "type": "string", "description": "Task ID. Omit for auto-generated ID. If provided and task exists, updates it. If provided and task does not exist, creates a new task with that ID (upsert)." },
                             "title": { "type": "string", "description": "Required for new tasks. Optional when updating (id present)." },
                             "status": {
                                 "type": "string",