@mcoda/core 0.1.18 → 0.1.19

package/dist/services/estimate/EstimateService.d.ts

@@ -8,6 +8,8 @@ export declare class EstimateService {
     private computeElapsedLaneHours;
     private computeDurations;
     private computeEtas;
+    private buildStatusCounts;
+    private buildCompletion;
     estimate(options: Omit<EstimateOptions, "workspace">): Promise<EstimateResult>;
     close(): Promise<void>;
 }

package/dist/services/estimate/EstimateService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EstimateService.d.ts","sourceRoot":"","sources":["../../../src/services/estimate/EstimateService.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAmC,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAI/E,qBAAa,eAAe;IACN,OAAO,CAAC,SAAS;IAArC,OAAO;WAEM,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAI7E,OAAO,CAAC,UAAU;YAMJ,uBAAuB;IAmCrC,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,WAAW;IA+Bb,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAwD9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}
+{"version":3,"file":"EstimateService.d.ts","sourceRoot":"","sources":["../../../src/services/estimate/EstimateService.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAmC,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAI/E,qBAAa,eAAe;IACN,OAAO,CAAC,SAAS;IAArC,OAAO;WAEM,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAI7E,OAAO,CAAC,UAAU;YAMJ,uBAAuB;IAmCrC,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,eAAe;IA0BjB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IA4D9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/services/estimate/EstimateService.js

@@ -91,6 +91,56 @@ export class EstimateService {
             completeEta,
         };
     }
+    buildStatusCounts(backlogTasks) {
+        const counts = {
+            total: backlogTasks.length,
+            readyToCodeReview: 0,
+            failed: 0,
+            inProgress: 0,
+            readyToQa: 0,
+            completed: 0,
+        };
+        for (const task of backlogTasks) {
+            const status = task.status.trim().toLowerCase();
+            if (status === "ready_to_code_review")
+                counts.readyToCodeReview += 1;
+            if (status === "failed")
+                counts.failed += 1;
+            if (status === "in_progress")
+                counts.inProgress += 1;
+            if (status === "ready_to_qa")
+                counts.readyToQa += 1;
+            if (status === "completed")
+                counts.completed += 1;
+        }
+        return counts;
+    }
+    buildCompletion(statusCounts) {
+        const ratio = (done, total) => {
+            if (!total || total <= 0)
+                return 0;
+            return Math.max(0, Math.min(100, (done / total) * 100));
+        };
+        const workDone = statusCounts.readyToCodeReview + statusCounts.readyToQa + statusCounts.completed;
+        const qaDone = statusCounts.readyToQa + statusCounts.completed;
+        return {
+            workOnTasks: {
+                done: workDone,
+                total: statusCounts.total,
+                percent: ratio(workDone, statusCounts.total),
+            },
+            readyToQa: {
+                done: qaDone,
+                total: statusCounts.total,
+                percent: ratio(qaDone, statusCounts.total),
+            },
+            done: {
+                done: statusCounts.completed,
+                total: statusCounts.total,
+                percent: ratio(statusCounts.completed, statusCounts.total),
+            },
+        };
+    }
     async estimate(options) {
         const backlogService = await BacklogService.create(this.workspace);
         let backlogTotals;
@@ -131,6 +181,8 @@ export class EstimateService {
         const elapsedImplementationHours = await this.computeElapsedLaneHours(inProgressTaskIds, "in_progress");
         const durationsHours = this.computeDurations(backlogTotals, effectiveVelocity, elapsedImplementationHours);
         const etas = this.computeEtas(backlogTotals, effectiveVelocity, durationsHours);
+        const statusCounts = this.buildStatusCounts(backlogTasks);
+        const completion = this.buildCompletion(statusCounts);
         return {
             scope: {
                 workspaceId: this.workspace.workspaceId,
@@ -143,6 +195,8 @@ export class EstimateService {
             effectiveVelocity,
             durationsHours,
             etas,
+            statusCounts,
+            completion,
         };
     }
     async close() {

package/dist/services/execution/WorkOnTasksService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkOnTasksService.d.ts","sourceRoot":"","sources":["../../../src/services/execution/WorkOnTasksService.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAgD,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAuB,MAAM,WAAW,CAAC;AAEvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAiB,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAsFrE,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,SAAS,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA6wBD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AA2rCzE,qBAAa,kBAAkB;IA0B3B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,IAAI;IA1Bd,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAqB;YAC7B,eAAe;gBAmBnB,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE;QACZ,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,EAAE,YAAY,CAAC;QACrB,UAAU,EAAE,UAAU,CAAC;QACvB,aAAa,EAAE,mBAAmB,CAAC;QACnC,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;QACxC,YAAY,CAAC,EAAE,gBAAgB,CAAC;QAChC,IAAI,EAAE,gBAAgB,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,cAAc,EAAE,cAAc,CAAC;QAC/B,aAAa,CAAC,EAAE,kBAAkB,CAAC;KACpC;YASW,WAAW;YAsDX,WAAW;YAIX,mBAAmB;YAOnB,oBAAoB;YAUpB,UAAU;WAUX,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6B1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B,qBAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;YAQlD,YAAY;IAU1B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,UAAU;YAMJ,OAAO;YAWP,gBAAgB;YAsChB,eAAe;YAcf,gBAAgB;IAsH9B,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,mBAAmB;IAmC3B,OAAO,CAAC,YAAY;YAgBN,kBAAkB;YASlB,WAAW;YAOX,2BAA2B;YAY3B,uBAAuB;IAwGrC,OAAO,CAAC,WAAW;YAsCL,kBAAkB;IAoBhC,OAAO,CAAC,cAAc;YAYR,oBAAoB;YAkDpB,cAAc;IAmM5B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,oBAAoB;YAGd,gBAAgB;IA6D9B,OAAO,CAAC,aAAa;YAiBP,yBAAyB;YA4CzB,sBAAsB;YA4DtB,YAAY;YAsOZ,eAAe;IAuE7B,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,qBAAqB;YASf,qBAAqB;YA0BrB,2BAA2B;YAkE3B,QAAQ;IA4ChB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAmhG3E"}
+{"version":3,"file":"WorkOnTasksService.d.ts","sourceRoot":"","sources":["../../../src/services/execution/WorkOnTasksService.ts"],"names":[],"mappings":"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"}

package/dist/services/execution/WorkOnTasksService.js

@@ -3405,7 +3405,9 @@ export class WorkOnTasksService {
         if (request.missingTestsPolicy && !requestedMissingTestsPolicy) {
             runnerWarnings.push(`Unknown missing-tests policy "${String(request.missingTestsPolicy)}"; using "${missingTestsPolicy}".`);
         }
-        const ignoreStatusFilter = Boolean(request.taskKeys?.length) || request.ignoreStatusFilter === true;
+        const explicitTaskSelection = Boolean(request.taskKeys?.length);
+        const ignoreDependencies = request.ignoreDependencies === true || explicitTaskSelection;
+        const ignoreStatusFilter = explicitTaskSelection || request.ignoreStatusFilter === true;
         const { filtered: statusFilter, rejected } = ignoreStatusFilter
             ? { filtered: request.statusFilter ?? [], rejected: [] }
             : filterTaskStatuses(request.statusFilter, WORK_ALLOWED_STATUSES, WORK_ALLOWED_STATUSES);
@@ -3443,7 +3445,7 @@ export class WorkOnTasksService {
                 ignoreStatusFilter,
                 includeTypes,
                 excludeTypes,
-                ignoreDependencies: true,
+                ignoreDependencies,
                 limit: request.limit,
                 parallel: request.parallel,
                 noCommit: request.noCommit ?? false,
@@ -3527,7 +3529,7 @@ export class WorkOnTasksService {
                 ignoreStatusFilter,
                 includeTypes,
                 excludeTypes,
-                ignoreDependencies: true,
+                ignoreDependencies,
                 limit: request.limit,
                 parallel: request.parallel,
             });

package/dist/services/planning/CreateTasksService.d.ts

@@ -58,6 +58,10 @@ export declare class CreateTasksService {
     });
     static create(workspace: WorkspaceResolution): Promise<CreateTasksService>;
     close(): Promise<void>;
+    private storyScopeKey;
+    private taskScopeKey;
+    private scopeStory;
+    private scopeTask;
     private seedPriorities;
     private resolveAgent;
     private ensureRatingService;
@@ -81,6 +85,7 @@ export declare class CreateTasksService {
     private shouldInjectStructureBootstrap;
     private injectStructureBootstrapPlan;
     private enforceStoryScopedDependencies;
+    private validatePlanLocalIdentifiers;
     private buildQaPreflight;
     private buildQaOverrides;
     private buildDocContext;

package/dist/services/planning/CreateTasksService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CreateTasksService.d.ts","sourceRoot":"","sources":["../../../src/services/planning/CreateTasksService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CreateTasksService.d.ts","sourceRoot":"","sources":["../../../src/services/planning/CreateTasksService.ts"],"names":[],"mappings":"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"}

package/dist/services/planning/CreateTasksService.js

@@ -593,6 +593,18 @@ export class CreateTasksService {
         const docdex = this.docdex;
         await swallow(docdex?.close?.bind(docdex));
     }
+    storyScopeKey(epicLocalId, storyLocalId) {
+        return `${epicLocalId}::${storyLocalId}`;
+    }
+    taskScopeKey(epicLocalId, storyLocalId, taskLocalId) {
+        return `${epicLocalId}::${storyLocalId}::${taskLocalId}`;
+    }
+    scopeStory(story) {
+        return this.storyScopeKey(story.epicLocalId, story.localId);
+    }
+    scopeTask(task) {
+        return this.taskScopeKey(task.epicLocalId, task.storyLocalId, task.localId);
+    }
     async seedPriorities(projectKey) {
         const ordering = await this.taskOrderingFactory(this.workspace, { recordTelemetry: false });
         try {
@@ -1068,7 +1080,7 @@ export class CreateTasksService {
         const services = this.sortServicesByDependency(Array.from(aliases.keys()), dependencies);
         return { services, dependencies, aliases };
     }
-    orderStoryTasksByDependencies(storyTasks, serviceRank, taskServiceByLocalId) {
+    orderStoryTasksByDependencies(storyTasks, serviceRank, taskServiceByScope) {
         const byLocalId = new Map(storyTasks.map((task) => [task.localId, task]));
         const indegree = new Map();
         const outgoing = new Map();
@@ -1090,8 +1102,8 @@ export class CreateTasksService {
             const classB = classifyTask({ title: b.title ?? "", description: b.description, type: b.type });
             if (classA.foundation !== classB.foundation)
                 return classA.foundation ? -1 : 1;
-            const rankA = serviceRank.get(taskServiceByLocalId.get(a.localId) ?? "") ?? Number.MAX_SAFE_INTEGER;
-            const rankB = serviceRank.get(taskServiceByLocalId.get(b.localId) ?? "") ?? Number.MAX_SAFE_INTEGER;
+            const rankA = serviceRank.get(taskServiceByScope.get(this.scopeTask(a)) ?? "") ?? Number.MAX_SAFE_INTEGER;
+            const rankB = serviceRank.get(taskServiceByScope.get(this.scopeTask(b)) ?? "") ?? Number.MAX_SAFE_INTEGER;
             if (rankA !== rankB)
                 return rankA - rankB;
             const priorityA = a.priorityHint ?? Number.MAX_SAFE_INTEGER;
@@ -1137,22 +1149,23 @@ export class CreateTasksService {
         const epics = plan.epics.map((epic) => ({ ...epic }));
         const stories = plan.stories.map((story) => ({ ...story }));
         const tasks = plan.tasks.map((task) => ({ ...task, dependsOnKeys: uniqueStrings(task.dependsOnKeys ?? []) }));
-        const storyByLocalId = new Map(stories.map((story) => [story.localId, story]));
-        const taskServiceByLocalId = new Map();
+        const storyByScope = new Map(stories.map((story) => [this.scopeStory(story), story]));
+        const taskServiceByScope = new Map();
         for (const task of tasks) {
             const text = `${task.title ?? ""}\n${task.description ?? ""}`;
-            taskServiceByLocalId.set(task.localId, resolveEntityService(text));
+            taskServiceByScope.set(this.scopeTask(task), resolveEntityService(text));
         }
         const tasksByStory = new Map();
         for (const task of tasks) {
-            const bucket = tasksByStory.get(task.storyLocalId) ?? [];
+            const storyScope = this.storyScopeKey(task.epicLocalId, task.storyLocalId);
+            const bucket = tasksByStory.get(storyScope) ?? [];
             bucket.push(task);
-            tasksByStory.set(task.storyLocalId, bucket);
+            tasksByStory.set(storyScope, bucket);
         }
         for (const storyTasks of tasksByStory.values()) {
             const tasksByService = new Map();
             for (const task of storyTasks) {
-                const service = taskServiceByLocalId.get(task.localId);
+                const service = taskServiceByScope.get(this.scopeTask(task));
                 if (!service)
                     continue;
                 const serviceTasks = tasksByService.get(service) ?? [];
@@ -1163,7 +1176,7 @@ export class CreateTasksService {
                 serviceTasks.sort((a, b) => (a.priorityHint ?? Number.MAX_SAFE_INTEGER) - (b.priorityHint ?? Number.MAX_SAFE_INTEGER));
             }
             for (const task of storyTasks) {
-                const service = taskServiceByLocalId.get(task.localId);
+                const service = taskServiceByScope.get(this.scopeTask(task));
                 if (!service)
                     continue;
                 const requiredServices = graph.dependencies.get(service);
@@ -1179,21 +1192,22 @@ export class CreateTasksService {
                 }
             }
         }
-        const storyRankByLocalId = new Map();
+        const storyRankByScope = new Map();
         for (const story of stories) {
-            const storyTasks = tasksByStory.get(story.localId) ?? [];
+            const storyScope = this.scopeStory(story);
+            const storyTasks = tasksByStory.get(storyScope) ?? [];
             const taskRanks = storyTasks
-                .map((task) => serviceRank.get(taskServiceByLocalId.get(task.localId) ?? ""))
+                .map((task) => serviceRank.get(taskServiceByScope.get(this.scopeTask(task)) ?? ""))
                 .filter((value) => typeof value === "number");
             const storyTextRank = serviceRank.get(resolveEntityService(`${story.title}\n${story.description ?? ""}\n${story.userStory ?? ""}`) ?? "");
             const rank = taskRanks.length > 0 ? Math.min(...taskRanks) : storyTextRank ?? Number.MAX_SAFE_INTEGER;
-            storyRankByLocalId.set(story.localId, rank);
+            storyRankByScope.set(storyScope, rank);
         }
         const epicRankByLocalId = new Map();
         for (const epic of epics) {
             const epicStories = stories.filter((story) => story.epicLocalId === epic.localId);
             const storyRanks = epicStories
-                .map((story) => storyRankByLocalId.get(story.localId))
+                .map((story) => storyRankByScope.get(this.scopeStory(story)))
                 .filter((value) => typeof value === "number");
             const epicTextRank = serviceRank.get(resolveEntityService(`${epic.title}\n${epic.description ?? ""}`) ?? "");
             const rank = storyRanks.length > 0 ? Math.min(...storyRanks) : epicTextRank ?? Number.MAX_SAFE_INTEGER;
@@ -1228,8 +1242,8 @@ export class CreateTasksService {
                 const bootstrapB = isBootstrap(`${b.title} ${b.description ?? ""}`);
                 if (bootstrapA !== bootstrapB)
                     return bootstrapA ? -1 : 1;
-                const rankA = storyRankByLocalId.get(a.localId) ?? Number.MAX_SAFE_INTEGER;
-                const rankB = storyRankByLocalId.get(b.localId) ?? Number.MAX_SAFE_INTEGER;
+                const rankA = storyRankByScope.get(this.scopeStory(a)) ?? Number.MAX_SAFE_INTEGER;
+                const rankB = storyRankByScope.get(this.scopeStory(b)) ?? Number.MAX_SAFE_INTEGER;
                 if (rankA !== rankB)
                     return rankA - rankB;
                 const priorityA = a.priorityHint ?? Number.MAX_SAFE_INTEGER;
@@ -1241,31 +1255,31 @@ export class CreateTasksService {
             epicStories.forEach((story, index) => {
                 story.priorityHint = index + 1;
                 storiesOrdered.push(story);
-                const storyTasks = tasksByStory.get(story.localId) ?? [];
-                const orderedTasks = this.orderStoryTasksByDependencies(storyTasks, serviceRank, taskServiceByLocalId);
+                const storyTasks = tasksByStory.get(this.scopeStory(story)) ?? [];
+                const orderedTasks = this.orderStoryTasksByDependencies(storyTasks, serviceRank, taskServiceByScope);
                 orderedTasks.forEach((task, taskIndex) => {
                     task.priorityHint = taskIndex + 1;
                     tasksOrdered.push(task);
                 });
             });
         }
-        const orderedStoryIds = new Set(storiesOrdered.map((story) => story.localId));
+        const orderedStoryScopes = new Set(storiesOrdered.map((story) => this.scopeStory(story)));
         for (const story of stories) {
-            if (orderedStoryIds.has(story.localId))
+            if (orderedStoryScopes.has(this.scopeStory(story)))
                 continue;
             storiesOrdered.push(story);
         }
-        const orderedTaskIds = new Set(tasksOrdered.map((task) => task.localId));
+        const orderedTaskScopes = new Set(tasksOrdered.map((task) => this.scopeTask(task)));
         for (const task of tasks) {
-            if (orderedTaskIds.has(task.localId))
+            if (orderedTaskScopes.has(this.scopeTask(task)))
                 continue;
             tasksOrdered.push(task);
         }
         // Keep parent linkage intact even if malformed story references exist.
         for (const story of storiesOrdered) {
-            if (!storyByLocalId.has(story.localId))
+            if (!storyByScope.has(this.scopeStory(story)))
                 continue;
-            story.epicLocalId = storyByLocalId.get(story.localId)?.epicLocalId ?? story.epicLocalId;
+            story.epicLocalId = storyByScope.get(this.scopeStory(story))?.epicLocalId ?? story.epicLocalId;
         }
         return { epics, stories: storiesOrdered, tasks: tasksOrdered };
     }
@@ -1395,9 +1409,8 @@ export class CreateTasksService {
         };
     }
     enforceStoryScopedDependencies(plan) {
-        const scopedLocalKey = (storyLocalId, localId) => `${storyLocalId}::${localId}`;
         const taskMap = new Map(plan.tasks.map((task) => [
-            scopedLocalKey(task.storyLocalId, task.localId),
+            this.scopeTask(task),
             {
                 ...task,
                 dependsOnKeys: uniqueStrings((task.dependsOnKeys ?? []).filter(Boolean)),
@@ -1405,9 +1418,10 @@ export class CreateTasksService {
         ]));
         const tasksByStory = new Map();
         for (const task of taskMap.values()) {
-            const storyTasks = tasksByStory.get(task.storyLocalId) ?? [];
+            const storyScope = this.storyScopeKey(task.epicLocalId, task.storyLocalId);
+            const storyTasks = tasksByStory.get(storyScope) ?? [];
             storyTasks.push(task);
-            tasksByStory.set(task.storyLocalId, storyTasks);
+            tasksByStory.set(storyScope, storyTasks);
         }
         for (const storyTasks of tasksByStory.values()) {
             const localIds = new Set(storyTasks.map((task) => task.localId));
@@ -1438,9 +1452,67 @@ export class CreateTasksService {
         }
         return {
             ...plan,
-            tasks: plan.tasks.map((task) => taskMap.get(scopedLocalKey(task.storyLocalId, task.localId)) ?? task),
+            tasks: plan.tasks.map((task) => taskMap.get(this.scopeTask(task)) ?? task),
         };
     }
+    validatePlanLocalIdentifiers(plan) {
+        const errors = [];
+        const epicIds = new Set();
+        for (const epic of plan.epics) {
+            if (!epic.localId || !epic.localId.trim()) {
+                errors.push("epic has missing localId");
+                continue;
+            }
+            if (epicIds.has(epic.localId)) {
+                errors.push(`duplicate epic localId: ${epic.localId}`);
+                continue;
+            }
+            epicIds.add(epic.localId);
+        }
+        const storyScopes = new Set();
+        for (const story of plan.stories) {
+            const scope = this.scopeStory(story);
+            if (!epicIds.has(story.epicLocalId)) {
+                errors.push(`story ${scope} references unknown epicLocalId ${story.epicLocalId}`);
+            }
+            if (storyScopes.has(scope)) {
+                errors.push(`duplicate story scope: ${scope}`);
+                continue;
+            }
+            storyScopes.add(scope);
+        }
+        const taskScopes = new Set();
+        const storyTaskLocals = new Map();
+        for (const task of plan.tasks) {
+            const storyScope = this.storyScopeKey(task.epicLocalId, task.storyLocalId);
+            const taskScope = this.scopeTask(task);
+            if (!storyScopes.has(storyScope)) {
+                errors.push(`task ${taskScope} references unknown story scope ${storyScope}`);
+            }
+            if (taskScopes.has(taskScope)) {
+                errors.push(`duplicate task scope: ${taskScope}`);
+                continue;
+            }
+            taskScopes.add(taskScope);
+            const locals = storyTaskLocals.get(storyScope) ?? new Set();
+            locals.add(task.localId);
+            storyTaskLocals.set(storyScope, locals);
+        }
+        for (const task of plan.tasks) {
+            const storyScope = this.storyScopeKey(task.epicLocalId, task.storyLocalId);
+            const localIds = storyTaskLocals.get(storyScope) ?? new Set();
+            for (const dep of task.dependsOnKeys ?? []) {
+                if (!dep || dep === task.localId)
+                    continue;
+                if (!localIds.has(dep)) {
+                    errors.push(`task ${this.scopeTask(task)} has dependency ${dep} that is outside story scope ${storyScope}`);
+                }
+            }
+        }
+        if (errors.length > 0) {
+            throw new Error(`Invalid generated plan local identifiers:\n- ${errors.join("\n- ")}`);
+        }
+    }
     async buildQaPreflight() {
         const preflight = {
             scripts: {},
@@ -1984,13 +2056,14 @@ export class CreateTasksService {
             for (const story of storyMeta) {
                 const storyId = storyIdByKey.get(story.storyKey);
                 const existingTaskKeys = storyId ? await this.workspaceRepo.listTaskKeys(storyId) : [];
-                const tasks = plan.tasks.filter((t) => t.storyLocalId === story.node.localId);
+                const tasks = plan.tasks.filter((t) => t.storyLocalId === story.node.localId && t.epicLocalId === story.node.epicLocalId);
                 const taskKeyGen = createTaskKeyGenerator(story.storyKey, existingTaskKeys);
                 for (const task of tasks) {
                     const key = taskKeyGen();
                     const localId = task.localId ?? key;
                     taskDetails.push({
                         localId,
+                        epicLocalId: story.node.epicLocalId,
                         key,
                         storyLocalId: story.node.localId,
                         storyKey: story.storyKey,
@@ -1999,8 +2072,8 @@ export class CreateTasksService {
                     });
                 }
             }
-            const scopedLocalKey = (storyLocalId, localId) => `${storyLocalId}::${localId}`;
-            const localToKey = new Map(taskDetails.map((t) => [scopedLocalKey(t.storyLocalId, t.localId), t.key]));
+            const scopedLocalKey = (epicLocalId, storyLocalId, localId) => this.taskScopeKey(epicLocalId, storyLocalId, localId);
+            const localToKey = new Map(taskDetails.map((t) => [scopedLocalKey(t.epicLocalId, t.storyLocalId, t.localId), t.key]));
             const taskInserts = [];
             const testCommandBuilder = new QaTestCommandBuilder(this.workspace.workspaceRoot);
             for (const task of taskDetails) {
@@ -2060,7 +2133,7 @@ export class CreateTasksService {
                     blockers: qaBlockers.length ? qaBlockers : undefined,
                 };
                 const depSlugs = (task.plan.dependsOnKeys ?? [])
-                    .map((dep) => localToKey.get(scopedLocalKey(task.storyLocalId, dep)))
+                    .map((dep) => localToKey.get(scopedLocalKey(task.plan.epicLocalId, task.storyLocalId, dep)))
                     .filter((value) => Boolean(value));
                 const metadata = {
                     doc_links: task.plan.relatedDocs ?? [],
@@ -2097,17 +2170,17 @@ export class CreateTasksService {
             for (const detail of taskDetails) {
                 const row = taskRows.find((t) => t.key === detail.key);
                 if (row) {
-                    taskByLocal.set(scopedLocalKey(detail.storyLocalId, detail.localId), row);
+                    taskByLocal.set(scopedLocalKey(detail.epicLocalId, detail.storyLocalId, detail.localId), row);
                 }
             }
             const depKeys = new Set();
             const dependencies = [];
             for (const detail of taskDetails) {
-                const current = taskByLocal.get(scopedLocalKey(detail.storyLocalId, detail.localId));
+                const current = taskByLocal.get(scopedLocalKey(detail.epicLocalId, detail.storyLocalId, detail.localId));
                 if (!current)
                     continue;
                 for (const dep of detail.plan.dependsOnKeys ?? []) {
-                    const target = taskByLocal.get(scopedLocalKey(detail.storyLocalId, dep));
+                    const target = taskByLocal.get(scopedLocalKey(detail.plan.epicLocalId, detail.storyLocalId, dep));
                     if (!target || target.id === current.id)
                         continue;
                     const depKey = `${current.id}|${target.id}|blocks`;
@@ -2214,6 +2287,7 @@ export class CreateTasksService {
                 plan = this.enforceStoryScopedDependencies(plan);
                 plan = this.applyServiceDependencySequencing(plan, docs);
                 plan = this.enforceStoryScopedDependencies(plan);
+                this.validatePlanLocalIdentifiers(plan);
                 await this.jobService.writeCheckpoint(job.id, {
                     stage: "stories_generated",
                     timestamp: new Date().toISOString(),
@@ -2343,6 +2417,7 @@ export class CreateTasksService {
             plan = this.enforceStoryScopedDependencies(plan);
             plan = this.applyServiceDependencySequencing(plan, []);
             plan = this.enforceStoryScopedDependencies(plan);
+            this.validatePlanLocalIdentifiers(plan);
             const loadRefinePlans = async () => {
                 const candidates = [];
                 if (options.refinePlanPath)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcoda/core",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "Core services and APIs for the mcoda CLI.",
   "type": "module",
   "main": "dist/index.js",
@@ -32,11 +32,11 @@
   "dependencies": {
     "@apidevtools/swagger-parser": "^10.1.0",
     "yaml": "^2.4.2",
-    "@mcoda/db": "0.1.18",
-    "@mcoda/agents": "0.1.18",
-    "@mcoda/integrations": "0.1.18",
-    "@mcoda/generators": "0.1.18",
-    "@mcoda/shared": "0.1.18"
+    "@mcoda/shared": "0.1.19",
+    "@mcoda/db": "0.1.19",
+    "@mcoda/agents": "0.1.19",
+    "@mcoda/generators": "0.1.19",
+    "@mcoda/integrations": "0.1.19"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",