fix(tasks): ensure list tasks triggers silent migration if necessary.

scripts/modules/task-manager/set-task-status.js

@@ -2,7 +2,14 @@ import path from 'path';
 import chalk from 'chalk';
 import boxen from 'boxen';
 
-import { log, readJSON, writeJSON, findTaskById } from '../utils.js';
+import {
+	log,
+	readJSON,
+	writeJSON,
+	findTaskById,
+	getCurrentTag,
+	ensureTagMetadata
+} from '../utils.js';
 import { displayBanner } from '../ui.js';
 import { validateTaskDependencies } from '../dependency-manager.js';
 import { getDebugFlag } from '../config-manager.js';
@@ -18,7 +25,7 @@ import {
  * @param {string} tasksPath - Path to the tasks.json file
  * @param {string} taskIdInput - Task ID(s) to update
  * @param {string} newStatus - New status
- * @param {Object} options - Additional options (mcpLog for MCP mode)
+ * @param {Object} options - Additional options (mcpLog for MCP mode, projectRoot for tag resolution)
  * @param {string} tag - Optional tag to override current tag resolution
  * @returns {Object|undefined} Result object in MCP mode, undefined in CLI mode
  */
@@ -50,7 +57,37 @@ async function setTaskStatus(
 		}
 
 		log('info', `Reading tasks from ${tasksPath}...`);
-		const data = readJSON(tasksPath, null, tag);
+
+		// Read the raw data without tag resolution to preserve tagged structure
+		let rawData = readJSON(tasksPath, options.projectRoot); // No tag parameter
+
+		// Handle the case where readJSON returns resolved data with _rawTaggedData
+		if (rawData && rawData._rawTaggedData) {
+			// Use the raw tagged data and discard the resolved view
+			rawData = rawData._rawTaggedData;
+		}
+
+		// Determine the current tag
+		const currentTag = tag || getCurrentTag(options.projectRoot) || 'master';
+
+		// Ensure the tag exists in the raw data
+		if (
+			!rawData ||
+			!rawData[currentTag] ||
+			!Array.isArray(rawData[currentTag].tasks)
+		) {
+			throw new Error(
+				`Invalid tasks file or tag "${currentTag}" not found at ${tasksPath}`
+			);
+		}
+
+		// Get the tasks for the current tag
+		const data = {
+			tasks: rawData[currentTag].tasks,
+			tag: currentTag,
+			_rawTaggedData: rawData
+		};
+
 		if (!data || !data.tasks) {
 			throw new Error(`No valid tasks found in ${tasksPath}`);
 		}
@@ -65,8 +102,17 @@ async function setTaskStatus(
 			updatedTasks.push(id);
 		}
 
-		// Write the updated tasks to the file
-		writeJSON(tasksPath, data);
+		// Update the raw data structure with the modified tasks
+		rawData[currentTag].tasks = data.tasks;
+
+		// Ensure the tag has proper metadata
+		ensureTagMetadata(rawData[currentTag], {
+			description: `Tasks for ${currentTag} context`
+		});
+
+		// Write the updated raw data back to the file
+		// The writeJSON function will automatically filter out _rawTaggedData
+		writeJSON(tasksPath, rawData);
 
 		// Validate dependencies after status update
 		log('info', 'Validating dependencies after status update...');