@mcoda/core 0.1.9 → 0.1.12

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

@@ -5,6 +5,7 @@ import { WorkspaceResolution } from "../../workspace/WorkspaceManager.js";
 import { JobService } from "../jobs/JobService.js";
 import { RoutingService } from "../agents/RoutingService.js";
 import { AgentRatingService } from "../agents/AgentRatingService.js";
+import { TaskOrderingService } from "../backlog/TaskOrderingService.js";
 export interface CreateTasksOptions {
     workspace: WorkspaceResolution;
     projectKey: string;
@@ -16,6 +17,10 @@ export interface CreateTasksOptions {
     maxStoriesPerEpic?: number;
     maxTasksPerStory?: number;
     force?: boolean;
+    qaProfiles?: string[];
+    qaEntryUrl?: string;
+    qaStartCommand?: string;
+    qaRequires?: string[];
 }
 export interface CreateTasksResult {
     jobId: string;
@@ -25,6 +30,10 @@ export interface CreateTasksResult {
     tasks: TaskRow[];
     dependencies: TaskDependencyRow[];
 }
+type TaskOrderingClient = Pick<TaskOrderingService, "orderTasks" | "close">;
+type TaskOrderingFactory = (workspace: WorkspaceResolution, options?: {
+    recordTelemetry?: boolean;
+}) => Promise<TaskOrderingClient>;
 export declare class CreateTasksService {
     private static readonly MAX_BUSY_RETRIES;
     private static readonly BUSY_BACKOFF_MS;
@@ -36,6 +45,7 @@ export declare class CreateTasksService {
     private routingService;
     private workspace;
     private ratingService?;
+    private taskOrderingFactory;
     constructor(workspace: WorkspaceResolution, deps: {
         docdex: DocdexClient;
         jobService: JobService;
@@ -44,13 +54,17 @@ export declare class CreateTasksService {
         workspaceRepo: WorkspaceRepository;
         routingService: RoutingService;
         ratingService?: AgentRatingService;
+        taskOrderingFactory?: TaskOrderingFactory;
     });
     static create(workspace: WorkspaceResolution): Promise<CreateTasksService>;
     close(): Promise<void>;
+    private seedPriorities;
     private resolveAgent;
     private ensureRatingService;
     private prepareDocs;
     private resolveDefaultDocInputs;
+    private buildQaPreflight;
+    private buildQaOverrides;
     private buildDocContext;
     private buildPrompt;
     private fallbackPlan;
@@ -71,4 +85,5 @@ export declare class CreateTasksService {
         refinePlansDir?: string;
     }): Promise<CreateTasksResult>;
 }
+export {};
 //# sourceMappingURL=CreateTasksService.d.ts.map

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

@@ -7,18 +7,124 @@ import { DocdexClient } from "@mcoda/integrations";
 import { JobService } from "../jobs/JobService.js";
 import { RoutingService } from "../agents/RoutingService.js";
 import { AgentRatingService } from "../agents/AgentRatingService.js";
+import { classifyTask } from "../backlog/TaskOrderingHeuristics.js";
+import { TaskOrderingService } from "../backlog/TaskOrderingService.js";
 import { createEpicKeyGenerator, createStoryKeyGenerator, createTaskKeyGenerator, } from "./KeyHelpers.js";
 const formatBullets = (items, fallback) => {
     if (!items || items.length === 0)
         return `- ${fallback}`;
     return items.map((item) => `- ${item}`).join("\n");
 };
+const normalizeStringArray = (value) => {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .filter((item) => typeof item === "string")
+        .map((item) => item.trim())
+        .filter(Boolean);
+};
+const normalizeEntrypoints = (value) => {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .map((entry) => {
+        if (!entry || typeof entry !== "object")
+            return null;
+        const record = entry;
+        const kind = record.kind;
+        if (kind !== "web" && kind !== "api" && kind !== "cli")
+            return null;
+        return {
+            kind,
+            base_url: typeof record.base_url === "string" ? record.base_url : undefined,
+            command: typeof record.command === "string" ? record.command : undefined,
+        };
+    })
+        .filter((entry) => Boolean(entry));
+};
+const normalizeQaReadiness = (value) => {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const record = value;
+    const qa = {
+        profiles_expected: normalizeStringArray(record.profiles_expected),
+        requires: normalizeStringArray(record.requires),
+        entrypoints: normalizeEntrypoints(record.entrypoints),
+        data_setup: normalizeStringArray(record.data_setup),
+        blockers: normalizeStringArray(record.blockers),
+        notes: typeof record.notes === "string" ? record.notes : undefined,
+    };
+    const hasValues = (qa.profiles_expected?.length ?? 0) > 0 ||
+        (qa.requires?.length ?? 0) > 0 ||
+        (qa.entrypoints?.length ?? 0) > 0 ||
+        (qa.data_setup?.length ?? 0) > 0 ||
+        (qa.blockers?.length ?? 0) > 0 ||
+        (qa.notes?.length ?? 0) > 0;
+    return hasValues ? qa : undefined;
+};
+const uniqueStrings = (items) => Array.from(new Set(items));
+const uniqueEntrypoints = (items) => {
+    const seen = new Set();
+    const result = [];
+    for (const entry of items) {
+        const key = `${entry.kind}|${entry.base_url ?? ""}|${entry.command ?? ""}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        result.push(entry);
+    }
+    return result;
+};
+const buildQaReadiness = (params) => {
+    const derivedProfiles = ["cli"];
+    if (params.classification.stage === "frontend")
+        derivedProfiles.push("chromium");
+    if (params.classification.stage === "backend")
+        derivedProfiles.push("api");
+    const profilesExpected = uniqueStrings([
+        ...derivedProfiles,
+        ...(params.overrides?.profiles_expected ?? []),
+        ...(params.planQa?.profiles_expected ?? []),
+    ]);
+    const entrypoints = uniqueEntrypoints([
+        ...(params.overrides?.entrypoints ?? []),
+        ...(params.planQa?.entrypoints ?? []),
+        ...(params.classification.stage === "frontend" ? params.preflight?.entrypoints ?? [] : []),
+    ]);
+    const blockers = uniqueStrings([
+        ...(params.overrides?.blockers ?? []),
+        ...(params.planQa?.blockers ?? []),
+        ...(params.preflight?.blockers ?? []),
+    ]);
+    if (params.classification.stage === "frontend" && entrypoints.length === 0) {
+        blockers.push("Missing UI entrypoint (dev/start script).");
+    }
+    return {
+        profiles_expected: profilesExpected,
+        requires: uniqueStrings([...(params.overrides?.requires ?? []), ...(params.planQa?.requires ?? [])]),
+        entrypoints: entrypoints.length ? entrypoints : undefined,
+        data_setup: uniqueStrings([...(params.overrides?.data_setup ?? []), ...(params.planQa?.data_setup ?? [])]),
+        blockers: blockers.length ? blockers : undefined,
+        notes: params.overrides?.notes ?? params.planQa?.notes,
+    };
+};
 const formatTestList = (items) => {
     if (!items || items.length === 0)
         return "Not applicable";
     return items.join("; ");
 };
 const ensureNonEmpty = (value, fallback) => value && value.trim().length > 0 ? value.trim() : fallback;
+const extractScriptPort = (script) => {
+    const matches = [script.match(/(?:--port|-p)\s*(\d{2,5})/), script.match(/PORT\s*=\s*(\d{2,5})/)];
+    for (const match of matches) {
+        if (!match)
+            continue;
+        const parsed = Number.parseInt(match[1] ?? "", 10);
+        if (Number.isFinite(parsed) && parsed > 0)
+            return parsed;
+    }
+    return undefined;
+};
 const estimateTokens = (text) => Math.max(1, Math.ceil(text.length / 4));
 const DOC_CONTEXT_BUDGET = 8000;
 const DOCDEX_HANDLE = /^docdex:/i;
@@ -214,7 +320,17 @@ const buildStoryDescription = (storyKey, title, userStory, description, acceptan
         formatBullets(relatedDocs, "Docdex handles, OpenAPI endpoints, code modules."),
     ].join("\n");
 };
-const buildTaskDescription = (taskKey, title, description, storyKey, epicKey, relatedDocs, dependencies, tests) => {
+const buildTaskDescription = (taskKey, title, description, storyKey, epicKey, relatedDocs, dependencies, tests, qa) => {
+    const formatEntrypoints = (entrypoints) => {
+        if (!entrypoints || entrypoints.length === 0)
+            return "- Not specified";
+        return entrypoints
+            .map((entry) => {
+            const target = entry.base_url ?? entry.command ?? "TBD";
+            return `- ${entry.kind}: ${target}`;
+        })
+            .join("\n");
+    };
     return [
         `* **Task Key**: ${taskKey}`,
         "* **Objective**",
@@ -235,6 +351,14 @@ const buildTaskDescription = (taskKey, title, description, storyKey, epicKey, re
         `- Component tests: ${formatTestList(tests.componentTests)}`,
         `- Integration tests: ${formatTestList(tests.integrationTests)}`,
         `- API tests: ${formatTestList(tests.apiTests)}`,
+        "* **QA Readiness**",
+        `- Profiles: ${qa?.profiles_expected?.length ? qa.profiles_expected.join(", ") : "TBD"}`,
+        `- Requires: ${qa?.requires?.length ? qa.requires.join("; ") : "None specified"}`,
+        `- Data setup: ${qa?.data_setup?.length ? qa.data_setup.join("; ") : "None specified"}`,
+        "* **QA Entry Points**",
+        formatEntrypoints(qa?.entrypoints),
+        "* **QA Blockers**",
+        formatBullets(qa?.blockers, "None known."),
         "* **Dependencies**",
         formatBullets(dependencies, "Enumerate prerequisite tasks by key."),
         "* **Risks & Gotchas**",
@@ -302,7 +426,14 @@ const TASK_SCHEMA_SNIPPET = `{
       "unitTests": ["unit test description"],
       "componentTests": ["component test description"],
       "integrationTests": ["integration test description"],
-      "apiTests": ["api test description"]
+      "apiTests": ["api test description"],
+      "qa": {
+        "profiles_expected": ["cli", "api", "chromium"],
+        "requires": ["dev server", "seed data"],
+        "entrypoints": [{ "kind": "web", "base_url": "http://localhost:<PORT>", "command": "npm run dev" }],
+        "data_setup": ["seed sample data"],
+        "notes": "optional QA notes"
+      }
     }
   ]
 }`;
@@ -316,14 +447,17 @@ export class CreateTasksService {
         this.workspaceRepo = deps.workspaceRepo;
         this.routingService = deps.routingService;
         this.ratingService = deps.ratingService;
+        this.taskOrderingFactory = deps.taskOrderingFactory ?? TaskOrderingService.create;
     }
     static async create(workspace) {
         const repo = await GlobalRepository.create();
         const agentService = new AgentService(repo);
         const routingService = await RoutingService.create();
+        const docdexRepoId = workspace.config?.docdexRepoId ?? process.env.MCODA_DOCDEX_REPO_ID ?? process.env.DOCDEX_REPO_ID;
         const docdex = new DocdexClient({
             workspaceRoot: workspace.workspaceRoot,
             baseUrl: workspace.config?.docdexUrl ?? process.env.MCODA_DOCDEX_URL,
+            repoId: docdexRepoId,
         });
         const jobService = new JobService(workspace);
         const workspaceRepo = await WorkspaceRepository.create(workspace.workspaceRoot);
@@ -354,6 +488,17 @@ export class CreateTasksService {
         const docdex = this.docdex;
         await swallow(docdex?.close?.bind(docdex));
     }
+    async seedPriorities(projectKey) {
+        const ordering = await this.taskOrderingFactory(this.workspace, { recordTelemetry: false });
+        try {
+            await ordering.orderTasks({
+                projectKey,
+            });
+        }
+        finally {
+            await ordering.close();
+        }
+    }
     async resolveAgent(agentName) {
         const resolved = await this.routingService.resolveAgentForCommand({
             workspace: this.workspace,
@@ -440,6 +585,106 @@ export class CreateTasksService {
         }
         return existing;
     }
+    async buildQaPreflight() {
+        const preflight = {
+            scripts: {},
+            entrypoints: [],
+            blockers: [],
+        };
+        const packagePath = path.join(this.workspace.workspaceRoot, "package.json");
+        let pkg = null;
+        try {
+            const raw = await fs.readFile(packagePath, "utf8");
+            pkg = JSON.parse(raw);
+        }
+        catch {
+            return preflight;
+        }
+        const scripts = pkg?.scripts;
+        if (scripts && typeof scripts === "object") {
+            for (const [name, value] of Object.entries(scripts)) {
+                if (typeof value === "string") {
+                    preflight.scripts[name] = value;
+                }
+            }
+        }
+        const dependencies = {
+            ...(pkg?.dependencies && typeof pkg.dependencies === "object" ? pkg.dependencies : {}),
+            ...(pkg?.devDependencies && typeof pkg.devDependencies === "object"
+                ? pkg.devDependencies
+                : {}),
+        };
+        const hasDev = typeof preflight.scripts.dev === "string";
+        const hasStart = typeof preflight.scripts.start === "string";
+        const devPort = hasDev ? extractScriptPort(preflight.scripts.dev) : undefined;
+        const startPort = hasStart ? extractScriptPort(preflight.scripts.start) : undefined;
+        if (hasDev) {
+            preflight.entrypoints.push({
+                kind: "web",
+                base_url: devPort ? `http://localhost:${devPort}` : undefined,
+                command: "npm run dev",
+            });
+        }
+        else if (hasStart) {
+            preflight.entrypoints.push({
+                kind: "web",
+                base_url: startPort ? `http://localhost:${startPort}` : undefined,
+                command: "npm start",
+            });
+        }
+        const testDirs = [
+            path.join(this.workspace.workspaceRoot, "tests"),
+            path.join(this.workspace.workspaceRoot, "__tests__"),
+        ];
+        const testFiles = [];
+        for (const dir of testDirs) {
+            try {
+                const stat = await fs.stat(dir);
+                if (!stat.isDirectory())
+                    continue;
+                testFiles.push(...(await collectFilesRecursively(dir)));
+            }
+            catch {
+                // ignore missing test dirs
+            }
+        }
+        const testCandidates = testFiles.filter((file) => /\b(test|spec)\b/i.test(path.basename(file)));
+        const hasSupertest = typeof dependencies.supertest === "string";
+        if (!hasSupertest && testCandidates.length > 0) {
+            for (const file of testCandidates) {
+                try {
+                    const content = await fs.readFile(file, "utf8");
+                    if (content.includes("supertest")) {
+                        preflight.blockers.push("Missing devDependency: supertest (required by test files).");
+                        break;
+                    }
+                }
+                catch {
+                    // ignore read errors
+                }
+            }
+        }
+        return preflight;
+    }
+    buildQaOverrides(options) {
+        const profiles = options.qaProfiles?.filter(Boolean);
+        const requires = options.qaRequires?.filter(Boolean);
+        const entrypoints = [];
+        if (options.qaEntryUrl || options.qaStartCommand) {
+            entrypoints.push({
+                kind: "web",
+                base_url: options.qaEntryUrl,
+                command: options.qaStartCommand,
+            });
+        }
+        if (!profiles?.length && !requires?.length && entrypoints.length === 0)
+            return undefined;
+        return {
+            profiles_expected: profiles,
+            requires,
+            entrypoints: entrypoints.length ? entrypoints : undefined,
+        };
+    }
     buildDocContext(docs) {
         const warnings = [];
         const blocks = [];
@@ -583,6 +828,7 @@ export class CreateTasksService {
         }
         let parsed = extractJson(output);
         if (!parsed) {
+            const attempt = 2;
             const fixPrompt = [
                 "Rewrite the previous response into valid JSON matching the expected schema.",
                 `Schema hint:\n${action === "epics" ? EPIC_SCHEMA_SNIPPET : action === "stories" ? STORY_SCHEMA_SNIPPET : TASK_SCHEMA_SNIPPET}`,
@@ -593,6 +839,32 @@ export class CreateTasksService {
                 const fix = await this.agentService.invoke(agent.id, { input: fixPrompt });
                 output = fix.output ?? "";
                 parsed = extractJson(output);
+                if (parsed) {
+                    const promptTokens = estimateTokens(prompt);
+                    const completionTokens = estimateTokens(output);
+                    const durationSeconds = (Date.now() - startedAt) / 1000;
+                    await this.jobService.recordTokenUsage({
+                        timestamp: new Date().toISOString(),
+                        workspaceId: this.workspace.workspaceId,
+                        jobId,
+                        commandRunId,
+                        agentId: agent.id,
+                        modelName: agent.defaultModel,
+                        promptTokens,
+                        completionTokens,
+                        tokensPrompt: promptTokens,
+                        tokensCompletion: completionTokens,
+                        tokensTotal: promptTokens + completionTokens,
+                        durationSeconds,
+                        metadata: {
+                            action: `create_tasks_${action}`,
+                            phase: `create_tasks_${action}`,
+                            attempt,
+                            ...(metadata ?? {}),
+                        },
+                    });
+                    return { output, promptTokens, completionTokens };
+                }
             }
             catch (error) {
                 throw new Error(`Agent retry failed (${action}): ${error.message}`);
@@ -617,7 +889,12 @@ export class CreateTasksService {
             tokensCompletion: completionTokens,
             tokensTotal: promptTokens + completionTokens,
             durationSeconds,
-            metadata: { action: `create_tasks_${action}`, ...(metadata ?? {}) },
+            metadata: {
+                action: `create_tasks_${action}`,
+                phase: `create_tasks_${action}`,
+                attempt: 1,
+                ...(metadata ?? {}),
+            },
         });
         return { output, promptTokens, completionTokens };
     }
@@ -692,6 +969,8 @@ export class CreateTasksService {
             "- Include test arrays: unitTests, componentTests, integrationTests, apiTests. Use [] when not applicable.",
             "- Only include tests that are relevant to the task's scope.",
             "- If the task involves code or configuration changes, include at least one relevant test; do not leave all test arrays empty unless it's purely documentation or research.",
+            "- When known, include qa object with profiles_expected/requires/entrypoints/data_setup to guide QA.",
+            "- Do not hardcode ports. For QA entrypoints, use http://localhost:<PORT> placeholders or omit base_url when unknown.",
             "- dependsOnKeys must reference localIds in this story.",
             "- Use docdex handles when citing docs.",
             `Story context (key=${story.key ?? story.localId ?? "TBD"}):`,
@@ -720,6 +999,7 @@ export class CreateTasksService {
             if (!hasTests && !docOnly) {
                 unitTests.push(`Add tests for ${title} (unit/component/integration/api as applicable)`);
             }
+            const qa = normalizeQaReadiness(task.qa);
             return {
                 localId: task.localId ?? `t${idx + 1}`,
                 title,
@@ -733,6 +1013,7 @@ export class CreateTasksService {
                 componentTests,
                 integrationTests,
                 apiTests,
+                qa,
             };
         })
             .filter((t) => t.title);
@@ -770,7 +1051,7 @@ export class CreateTasksService {
         return { epics: planEpics, stories: planStories, tasks: planTasks };
     }
     async writePlanArtifacts(projectKey, plan, docSummary) {
-        const baseDir = path.join(this.workspace.workspaceRoot, ".mcoda", "tasks", projectKey);
+        const baseDir = path.join(this.workspace.mcodaDir, "tasks", projectKey);
         await fs.mkdir(baseDir, { recursive: true });
         const write = async (file, data) => {
             const target = path.join(baseDir, file);
@@ -863,6 +1144,17 @@ export class CreateTasksService {
                 const epicId = epicIdByKey.get(task.epicKey);
                 if (!storyId || !epicId)
                     continue;
+                const classification = classifyTask({
+                    title: task.plan.title ?? `Task ${task.key}`,
+                    description: task.plan.description,
+                    type: task.plan.type,
+                });
+                const qaReadiness = buildQaReadiness({
+                    classification,
+                    planQa: task.plan.qa,
+                    preflight: options?.qaPreflight,
+                    overrides: options?.qaOverrides,
+                });
                 const depSlugs = (task.plan.dependsOnKeys ?? [])
                     .map((dep) => localToKey.get(dep))
                     .filter((value) => Boolean(value));
@@ -877,7 +1169,7 @@ export class CreateTasksService {
                         componentTests: task.plan.componentTests,
                         integrationTests: task.plan.integrationTests,
                         apiTests: task.plan.apiTests,
-                    }),
+                    }, qaReadiness),
                     type: task.plan.type ?? "feature",
                     status: "not_started",
                     storyPoints: task.plan.estimatedStoryPoints ?? null,
@@ -890,6 +1182,9 @@ export class CreateTasksService {
                             integration: task.plan.integrationTests ?? [],
                             api: task.plan.apiTests ?? [],
                         },
+                        stage: classification.stage,
+                        foundation: classification.foundation,
+                        qa: qaReadiness,
                     },
                 });
             }
@@ -983,11 +1278,18 @@ export class CreateTasksService {
                 const docs = await this.prepareDocs(options.inputs);
                 const { docSummary, warnings: docWarnings } = this.buildDocContext(docs);
                 const { prompt } = this.buildPrompt(options.projectKey, docs, options);
+                const qaPreflight = await this.buildQaPreflight();
+                const qaOverrides = this.buildQaOverrides(options);
                 await this.jobService.writeCheckpoint(job.id, {
                     stage: "docs_indexed",
                     timestamp: new Date().toISOString(),
                     details: { count: docs.length, warnings: docWarnings },
                 });
+                await this.jobService.writeCheckpoint(job.id, {
+                    stage: "qa_preflight",
+                    timestamp: new Date().toISOString(),
+                    details: qaPreflight,
+                });
                 const agent = await this.resolveAgent(options.agentName);
                 const { output: epicOutput } = await this.invokeAgentWithRetry(agent, prompt, "epics", agentStream, job.id, commandRun.id, { docWarnings });
                 const epics = this.parseEpics(epicOutput, docs, options.projectKey).slice(0, options.maxEpics ?? Number.MAX_SAFE_INTEGER);
@@ -1022,7 +1324,10 @@ export class CreateTasksService {
                 const { epics: epicRows, stories: storyRows, tasks: taskRows, dependencies: dependencyRows } = await this.persistPlanToDb(project.id, options.projectKey, plan, job.id, commandRun.id, {
                     force: options.force,
                     resetKeys: options.force,
+                    qaPreflight,
+                    qaOverrides,
                 });
+                await this.seedPriorities(options.projectKey);
                 await this.jobService.updateJobStatus(job.id, "completed", {
                     payload: {
                         epicsCreated: epicRows.length,
@@ -1093,7 +1398,7 @@ export class CreateTasksService {
             commandName: "migrate-tasks",
             payload: { projectKey, planDir: options.planDir },
         });
-        const planDir = options.planDir ?? path.join(this.workspace.workspaceRoot, ".mcoda", "tasks", projectKey);
+        const planDir = options.planDir ?? path.join(this.workspace.mcodaDir, "tasks", projectKey);
         try {
             const planPath = path.join(planDir, "plan.json");
             const loadJson = async (file) => {

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

@@ -41,7 +41,9 @@ export declare class RefineTasksService {
     });
     static create(workspace: WorkspaceResolution): Promise<RefineTasksService>;
     close(): Promise<void>;
+    private seedPriorities;
     private resolveAgent;
+    private selectFallbackAgent;
     private ensureRatingService;
     private selectTasks;
     private parseTaskKeyParts;
@@ -51,8 +53,10 @@ export declare class RefineTasksService {
     private summarizeHistory;
     private logWarningsToTasks;
     private mergeMetadata;
+    private applyStageMetadata;
     private validateOperation;
     private detectCycle;
+    private hasDependencyPath;
     private applyOperations;
     private invokeAgent;
     refineTasks(options: RefineTasksOptions): Promise<RefineTasksResult>;

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

@@ -1 +1 @@
-{"version":3,"file":"RefineTasksService.d.ts","sourceRoot":"","sources":["../../../src/services/planning/RefineTasksService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAA6C,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC7G,OAAO,EAIL,kBAAkB,EAClB,iBAAiB,EAGlB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGrE,UAAU,kBAAmB,SAAQ,kBAAkB;IACrD,SAAS,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAmLD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAqB;gBAGzC,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE;QACJ,MAAM,EAAE,YAAY,CAAC;QACrB,UAAU,EAAE,UAAU,CAAC;QACvB,YAAY,EAAE,YAAY,CAAC;QAC3B,IAAI,EAAE,gBAAgB,CAAC;QACvB,aAAa,EAAE,mBAAmB,CAAC;QACnC,cAAc,EAAE,cAAc,CAAC;QAC/B,aAAa,CAAC,EAAE,kBAAkB,CAAC;KACpC;WAYU,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoB1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBd,YAAY;IAS1B,OAAO,CAAC,mBAAmB;YAYb,WAAW;IA4KzB,OAAO,CAAC,iBAAiB;YASX,gBAAgB;IAkK9B,OAAO,CAAC,gBAAgB;YA8BV,aAAa;YAoDb,gBAAgB;YA+BhB,kBAAkB;IAkChC,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,iBAAiB;IA8EzB,OAAO,CAAC,WAAW;YA0BL,eAAe;YAoSf,WAAW;IA6FnB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAka3E"}
+{"version":3,"file":"RefineTasksService.d.ts","sourceRoot":"","sources":["../../../src/services/planning/RefineTasksService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAA6C,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC7G,OAAO,EAIL,kBAAkB,EAClB,iBAAiB,EAKlB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAKrE,UAAU,kBAAmB,SAAQ,kBAAkB;IACrD,SAAS,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAuLD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAqB;gBAGzC,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE;QACJ,MAAM,EAAE,YAAY,CAAC;QACrB,UAAU,EAAE,UAAU,CAAC;QACvB,YAAY,EAAE,YAAY,CAAC;QAC3B,IAAI,EAAE,gBAAgB,CAAC;QACvB,aAAa,EAAE,mBAAmB,CAAC;QACnC,cAAc,EAAE,cAAc,CAAC;QAC/B,aAAa,CAAC,EAAE,kBAAkB,CAAC;KACpC;WAYU,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuB1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBd,cAAc;YAWd,YAAY;YAwBZ,mBAAmB;IA4CjC,OAAO,CAAC,mBAAmB;YAYb,WAAW;IA4KzB,OAAO,CAAC,iBAAiB;YASX,gBAAgB;IAmK9B,OAAO,CAAC,gBAAgB;YA8BV,aAAa;YAoDb,gBAAgB;YA+BhB,kBAAkB;IAkChC,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,iBAAiB;IA8EzB,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,iBAAiB;YAkBX,eAAe;YAqYf,WAAW;IAmGnB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAma3E"}