chore: apply requested changes

scripts/modules/task-manager/scope-adjustment.js

@@ -392,12 +392,29 @@ Ensure the JSON is valid and properly formatted.`;
 			0
 		);
 		let nextId = maxPreservedId + 1;
-		const normalizedGeneratedSubtasks = processedGeneratedSubtasks.map(
-			(st) => ({
-				...st,
-				id: nextId++
+		const idMapping = new Map();
+		const normalizedGeneratedSubtasks = processedGeneratedSubtasks
+			.map((st) => {
+				const originalId = st.id;
+				const newId = nextId++;
+				idMapping.set(originalId, newId);
+				return {
+					...st,
+					id: newId
+				};
 			})
-		);
+			.map((st) => ({
+				...st,
+				dependencies: (st.dependencies || []).map((dep) => {
+					if (typeof dep !== 'string' || !dep.startsWith(`${task.id}.`)) {
+						return dep;
+					}
+					const [, siblingIdPart] = dep.split('.');
+					const originalSiblingId = Number.parseInt(siblingIdPart, 10);
+					const remappedSiblingId = idMapping.get(originalSiblingId);
+					return remappedSiblingId ? `${task.id}.${remappedSiblingId}` : dep;
+				})
+			}));
 
 		// Update task with preserved subtasks + newly generated ones
 		task.subtasks = [...preservedSubtasks, ...normalizedGeneratedSubtasks];
@@ -406,7 +423,7 @@ Ensure the JSON is valid and properly formatted.`;
 			updatedTask: task,
 			regenerated: true,
 			preserved: preservedSubtasks.length,
-			generated: processedGeneratedSubtasks.length
+			generated: normalizedGeneratedSubtasks.length
 		};
 	} catch (error) {
 		log(

scripts/modules/task-manager/update-task-by-id.js

@@ -33,33 +33,36 @@ import { ContextGatherer } from '../utils/contextGatherer.js';
 import { FuzzyTaskSearch } from '../utils/fuzzyTaskSearch.js';
 
 // Zod schema for post-parsing validation of the updated task object
-const updatedTaskSchema = z.object({
-	id: z.int(),
-	title: z.string(), // Title should be preserved, but check it exists
-	description: z.string(),
-	status: z.string(),
-	dependencies: z.array(z.union([z.int(), z.string()])),
-	priority: z.string().nullable().prefault('medium'),
-	details: z.string().nullable().prefault(''),
-	testStrategy: z.string().nullable().prefault(''),
-	subtasks: z
-		.array(
-			z.object({
-				id: z
-					.int()
-					.positive()
-					.describe('Sequential subtask ID starting from 1'),
-				title: z.string(),
-				description: z.string(),
-				status: z.string(),
-				dependencies: z.array(z.int()).nullable().prefault([]),
-				details: z.string().nullable().prefault(''),
-				testStrategy: z.string().nullable().prefault('')
-			})
-		)
-		.nullable()
-		.prefault([])
-}); // Allows parsing even if AI adds extra fields, but validation focuses on schema
+const updatedTaskSchema = z
+	.object({
+		id: z.number().int(),
+		title: z.string(), // Title should be preserved, but check it exists
+		description: z.string(),
+		status: z.string(),
+		dependencies: z.array(z.union([z.number().int(), z.string()])),
+		priority: z.string().nullable().prefault('medium'),
+		details: z.string().nullable().prefault(''),
+		testStrategy: z.string().nullable().prefault(''),
+		subtasks: z
+			.array(
+				z.object({
+					id: z
+						.number()
+						.int()
+						.positive()
+						.describe('Sequential subtask ID starting from 1'),
+					title: z.string(),
+					description: z.string(),
+					status: z.string(),
+					dependencies: z.array(z.number().int()).nullable().prefault([]),
+					details: z.string().nullable().prefault(''),
+					testStrategy: z.string().nullable().prefault('')
+				})
+			)
+			.nullable()
+			.prefault([])
+	})
+	.strip(); // Enforce the canonical task shape and drop unknown fields
 
 /**
  * Parses a single updated task object from AI's text response.

scripts/modules/task-manager/update-tasks.js

@@ -29,17 +29,19 @@ import { FuzzyTaskSearch } from '../utils/fuzzyTaskSearch.js';
 import { flattenTasksWithSubtasks, findProjectRoot } from '../utils.js';
 
 // Zod schema for validating the structure of tasks AFTER parsing
-const updatedTaskSchema = z.object({
-	id: z.int(),
-	title: z.string(),
-	description: z.string(),
-	status: z.string(),
-	dependencies: z.array(z.union([z.int(), z.string()])),
-	priority: z.string().nullable(),
-	details: z.string().nullable(),
-	testStrategy: z.string().nullable(),
-	subtasks: z.array(z.any()).nullable() // Keep subtasks flexible for now
-}); // Allow potential extra fields during parsing if needed, then validate structure
+const updatedTaskSchema = z
+	.object({
+		id: z.int(),
+		title: z.string(),
+		description: z.string(),
+		status: z.string(),
+		dependencies: z.array(z.union([z.int(), z.string()])),
+		priority: z.string().nullable(),
+		details: z.string().nullable(),
+		testStrategy: z.string().nullable(),
+		subtasks: z.array(z.any()).nullable() // Keep subtasks flexible for now
+	})
+	.strip(); // Enforce the canonical task shape and drop unknown fields
 
 // Preprocessing schema that adds defaults before validation
 const preprocessTaskSchema = z.preprocess((task) => {