@mcoda/core 0.1.20 → 0.1.22

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export * from "./services/planning/RefineTasksService.js";
 export * from "./services/planning/KeyHelpers.js";
 export * from "./services/execution/TaskSelectionService.js";
 export * from "./services/execution/TaskStateService.js";
+export * from "./services/execution/AddTestsService.js";
 export * from "./services/execution/WorkOnTasksService.js";
 export * from "./services/execution/QaTasksService.js";
 export * from "./services/execution/GatewayTrioService.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC;AACzD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC;AACzD,cAAc,yCAAyC,CAAC;AACxD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC"}

package/dist/index.js

@@ -9,6 +9,7 @@ export * from "./services/planning/RefineTasksService.js";
 export * from "./services/planning/KeyHelpers.js";
 export * from "./services/execution/TaskSelectionService.js";
 export * from "./services/execution/TaskStateService.js";
+export * from "./services/execution/AddTestsService.js";
 export * from "./services/execution/WorkOnTasksService.js";
 export * from "./services/execution/QaTasksService.js";
 export * from "./services/execution/GatewayTrioService.js";

package/dist/services/execution/AddTestsService.d.ts

@@ -0,0 +1,48 @@
+import { WorkspaceRepository } from "@mcoda/db";
+import { VcsClient } from "@mcoda/integrations";
+import { WorkspaceResolution } from "../../workspace/WorkspaceManager.js";
+import { TaskSelectionFilters, TaskSelectionService } from "./TaskSelectionService.js";
+type AddTestsDeps = {
+    workspaceRepo: WorkspaceRepository;
+    selectionService: TaskSelectionService;
+    vcsClient?: VcsClient;
+};
+export interface AddTestsRequest extends TaskSelectionFilters {
+    projectKey: string;
+    dryRun?: boolean;
+    commit?: boolean;
+    baseBranch?: string;
+}
+export interface AddTestsResult {
+    projectKey: string;
+    selectedTaskKeys: string[];
+    tasksRequiringTests: string[];
+    updatedTaskKeys: string[];
+    skippedTaskKeys: string[];
+    createdFiles: string[];
+    runAllScriptPath?: string;
+    runAllCommand?: string;
+    branch?: string;
+    commitSha?: string;
+    warnings: string[];
+}
+export declare class AddTestsService {
+    private workspace;
+    private readonly workspaceRepo;
+    private readonly selectionService;
+    private readonly vcs;
+    private readonly ownsWorkspaceRepo;
+    private readonly ownsSelectionService;
+    constructor(workspace: WorkspaceResolution, deps: AddTestsDeps, ownership?: {
+        ownsWorkspaceRepo?: boolean;
+        ownsSelectionService?: boolean;
+    });
+    static create(workspace: WorkspaceResolution): Promise<AddTestsService>;
+    close(): Promise<void>;
+    private resolveTaskSelection;
+    private resolveTaskCommands;
+    private ensureBaseBranchForCommit;
+    addTests(request: AddTestsRequest): Promise<AddTestsResult>;
+}
+export {};
+//# sourceMappingURL=AddTestsService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AddTestsService.d.ts","sourceRoot":"","sources":["../../../src/services/execution/AddTestsService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAA0B,MAAM,2BAA2B,CAAC;AAa/G,KAAK,YAAY,GAAG;IAClB,aAAa,EAAE,mBAAmB,CAAC;IACnC,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA+ID,qBAAa,eAAe;IAQxB,OAAO,CAAC,SAAS;IAPnB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAU;gBAGrC,SAAS,EAAE,mBAAmB,EACtC,IAAI,EAAE,YAAY,EAClB,SAAS,GAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;KAAO;WASpE,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAUvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAUd,oBAAoB;YAqBpB,mBAAmB;YAoBnB,yBAAyB;IAqBjC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAoIlE"}

package/dist/services/execution/AddTestsService.js

@@ -0,0 +1,346 @@
+import fs from "node:fs";
+import path from "node:path";
+import { WorkspaceRepository } from "@mcoda/db";
+import { VcsClient } from "@mcoda/integrations";
+import { PathHelper, WORK_ALLOWED_STATUSES, filterTaskStatuses } from "@mcoda/shared";
+import { QaTestCommandBuilder } from "./QaTestCommandBuilder.js";
+import { TaskSelectionService } from "./TaskSelectionService.js";
+const DEFAULT_BASE_BRANCH = "mcoda-dev";
+const MISSING_HARNESS_BLOCKER = /No runnable test harness discovered/i;
+const FALLBACK_BOOTSTRAP_COMMAND = "node -e \"console.log('mcoda add-tests bootstrap placeholder')\"";
+const normalizeStringArray = (value) => {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .filter((item) => typeof item === "string")
+        .map((item) => item.trim())
+        .filter(Boolean);
+};
+const normalizeTestCommands = (value) => {
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        return trimmed ? [trimmed] : [];
+    }
+    return normalizeStringArray(value);
+};
+const normalizeTestRequirements = (value) => {
+    const raw = value && typeof value === "object" ? value : {};
+    return {
+        unit: normalizeStringArray(raw.unit),
+        component: normalizeStringArray(raw.component),
+        integration: normalizeStringArray(raw.integration),
+        api: normalizeStringArray(raw.api),
+    };
+};
+const hasTestRequirements = (requirements) => requirements.unit.length > 0 ||
+    requirements.component.length > 0 ||
+    requirements.integration.length > 0 ||
+    requirements.api.length > 0;
+const dedupeCommands = (commands) => {
+    const seen = new Set();
+    const result = [];
+    for (const command of commands) {
+        const trimmed = command.trim();
+        if (!trimmed || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        result.push(trimmed);
+    }
+    return result;
+};
+const resolveNodeCommand = () => {
+    const override = process.env.NODE_BIN?.trim();
+    const resolved = override || (process.platform === "win32" ? "node.exe" : "node");
+    return resolved.includes(" ") ? `"${resolved}"` : resolved;
+};
+const quoteShellPath = (value) => (value.includes(" ") ? `"${value}"` : value);
+const buildRunAllTestsCommand = (relativePath) => {
+    const normalized = relativePath.split(path.sep).join("/");
+    if (normalized.endsWith(".js"))
+        return `${resolveNodeCommand()} ${normalized}`;
+    if (normalized.endsWith(".ps1")) {
+        const shell = process.platform === "win32" ? "powershell" : "pwsh";
+        return `${shell} -File ${quoteShellPath(normalized)}`;
+    }
+    if (normalized.endsWith(".sh"))
+        return `bash ${quoteShellPath(normalized)}`;
+    if (normalized.startsWith("."))
+        return normalized;
+    return `./${normalized}`;
+};
+const detectRunAllTestsScript = (workspaceRoot) => {
+    const candidates = ["tests/all.js", "tests/all.sh", "tests/all.ps1", "tests/all"];
+    for (const candidate of candidates) {
+        if (fs.existsSync(path.join(workspaceRoot, ...candidate.split("/"))))
+            return candidate;
+    }
+    return undefined;
+};
+const detectRunAllTestsCommand = (workspaceRoot) => {
+    const script = detectRunAllTestsScript(workspaceRoot);
+    if (!script)
+        return undefined;
+    return buildRunAllTestsCommand(script);
+};
+const pickSeedTestCategory = (requirements) => {
+    const order = ["unit", "component", "integration", "api"];
+    const active = order.filter((key) => requirements[key].length > 0);
+    if (active.length === 1)
+        return active[0];
+    return "unit";
+};
+const buildRunAllTestsScript = (seedCategory, seedCommands) => {
+    const suites = {
+        unit: [],
+        component: [],
+        integration: [],
+        api: [],
+    };
+    suites[seedCategory] = seedCommands;
+    return [
+        "#!/usr/bin/env node",
+        'const { spawnSync } = require("node:child_process");',
+        "",
+        "// Register test commands per discipline.",
+        `const testSuites = ${JSON.stringify(suites, null, 2)};`,
+        "",
+        'const entries = Object.entries(testSuites).flatMap(([label, commands]) =>',
+        "  commands.map((command) => ({ label, command }))",
+        ");",
+        "if (!entries.length) {",
+        '  console.error("No test commands registered in tests/all.js. Add unit/component/integration/api commands.");',
+        "  process.exit(1);",
+        "}",
+        "",
+        'console.log("MCODA_RUN_ALL_TESTS_START");',
+        "let failed = false;",
+        "for (const entry of entries) {",
+        "  const result = spawnSync(entry.command, { shell: true, stdio: \"inherit\" });",
+        "  const status = typeof result.status === \"number\" ? result.status : 1;",
+        "  if (status !== 0) failed = true;",
+        "}",
+        'console.log(`MCODA_RUN_ALL_TESTS_COMPLETE status=${failed ? "failed" : "passed"}`);',
+        'console.log("MCODA_RUN_ALL_TESTS_END");',
+        "process.exit(failed ? 1 : 0);",
+        "",
+    ].join("\n");
+};
+const stripHarnessBlocker = (metadata) => {
+    const rawQa = metadata.qa;
+    if (!rawQa || typeof rawQa !== "object")
+        return metadata;
+    const qa = { ...rawQa };
+    const blockers = normalizeStringArray(qa.blockers).filter((entry) => !MISSING_HARNESS_BLOCKER.test(entry));
+    if (blockers.length > 0) {
+        qa.blockers = blockers;
+    }
+    else {
+        delete qa.blockers;
+    }
+    return { ...metadata, qa };
+};
+export class AddTestsService {
+    constructor(workspace, deps, ownership = {}) {
+        this.workspace = workspace;
+        this.workspaceRepo = deps.workspaceRepo;
+        this.selectionService = deps.selectionService;
+        this.vcs = deps.vcsClient ?? new VcsClient();
+        this.ownsWorkspaceRepo = ownership.ownsWorkspaceRepo === true;
+        this.ownsSelectionService = ownership.ownsSelectionService === true;
+    }
+    static async create(workspace) {
+        const workspaceRepo = await WorkspaceRepository.create(workspace.workspaceRoot);
+        const selectionService = new TaskSelectionService(workspace, workspaceRepo);
+        return new AddTestsService(workspace, { workspaceRepo, selectionService }, { ownsWorkspaceRepo: true, ownsSelectionService: true });
+    }
+    async close() {
+        if (this.ownsSelectionService) {
+            await this.selectionService.close();
+            return;
+        }
+        if (this.ownsWorkspaceRepo) {
+            await this.workspaceRepo.close();
+        }
+    }
+    async resolveTaskSelection(request) {
+        const ignoreStatusFilter = request.taskKeys?.length ? true : request.ignoreStatusFilter;
+        const { filtered } = ignoreStatusFilter
+            ? { filtered: request.statusFilter ?? [] }
+            : filterTaskStatuses(request.statusFilter, WORK_ALLOWED_STATUSES, WORK_ALLOWED_STATUSES);
+        return this.selectionService.selectTasks({
+            projectKey: request.projectKey,
+            epicKey: request.epicKey,
+            storyKey: request.storyKey,
+            taskKeys: request.taskKeys,
+            statusFilter: filtered,
+            ignoreStatusFilter,
+            includeTypes: request.includeTypes,
+            excludeTypes: request.excludeTypes,
+            limit: request.limit,
+            parallel: request.parallel,
+            ignoreDependencies: request.ignoreDependencies ?? true,
+            missingContextPolicy: request.missingContextPolicy ?? "allow",
+        });
+    }
+    async resolveTaskCommands(task) {
+        const metadata = (task.task.metadata ?? {});
+        const requirements = normalizeTestRequirements(metadata.test_requirements ?? metadata.testRequirements);
+        const existingCommands = dedupeCommands(normalizeTestCommands(metadata.tests ?? metadata.testCommands));
+        if (!hasTestRequirements(requirements)) {
+            return { requirements, existingCommands, discoveredCommands: [] };
+        }
+        if (existingCommands.length > 0) {
+            return { requirements, existingCommands, discoveredCommands: existingCommands };
+        }
+        const commandBuilder = new QaTestCommandBuilder(this.workspace.workspaceRoot);
+        try {
+            const plan = await commandBuilder.build({ task: task.task });
+            const discoveredCommands = dedupeCommands(plan.commands);
+            return { requirements, existingCommands, discoveredCommands };
+        }
+        catch {
+            return { requirements, existingCommands, discoveredCommands: [] };
+        }
+    }
+    async ensureBaseBranchForCommit(baseBranch) {
+        const cwd = this.workspace.workspaceRoot;
+        const isRepo = await this.vcs.isRepo(cwd);
+        if (!isRepo) {
+            return { warning: "add-tests commit skipped: workspace is not a git repository." };
+        }
+        const status = await this.vcs.status(cwd);
+        if (status.trim().length > 0) {
+            return { warning: "add-tests commit skipped: working tree is dirty before bootstrap." };
+        }
+        try {
+            await this.vcs.ensureBaseBranch(cwd, baseBranch);
+            await this.vcs.checkoutBranch(cwd, baseBranch);
+            return { branch: baseBranch };
+        }
+        catch (error) {
+            return {
+                warning: `add-tests commit skipped: failed to prepare base branch ${baseBranch} (${error.message}).`,
+            };
+        }
+    }
+    async addTests(request) {
+        const warnings = [];
+        const createdFiles = [];
+        const updatedTaskKeys = [];
+        const skippedTaskKeys = [];
+        const dryRun = request.dryRun === true;
+        const commitEnabled = request.commit !== false && !dryRun;
+        const selection = await this.resolveTaskSelection(request);
+        const selectedTaskKeys = selection.ordered.map((entry) => entry.task.key);
+        warnings.push(...selection.warnings);
+        const requiringTests = [];
+        for (const entry of selection.ordered) {
+            const commands = await this.resolveTaskCommands(entry);
+            if (!hasTestRequirements(commands.requirements))
+                continue;
+            requiringTests.push({ entry, commands });
+        }
+        const tasksRequiringTests = requiringTests.map((item) => item.entry.task.key);
+        if (tasksRequiringTests.length === 0) {
+            return {
+                projectKey: request.projectKey,
+                selectedTaskKeys,
+                tasksRequiringTests: [],
+                updatedTaskKeys,
+                skippedTaskKeys,
+                createdFiles,
+                warnings,
+            };
+        }
+        let runAllScriptPath = detectRunAllTestsScript(this.workspace.workspaceRoot);
+        let runAllCommand = runAllScriptPath ? buildRunAllTestsCommand(runAllScriptPath) : undefined;
+        let commitBranch;
+        let commitSha;
+        const baseBranch = (request.baseBranch ?? this.workspace.config?.branch ?? DEFAULT_BASE_BRANCH).trim() || DEFAULT_BASE_BRANCH;
+        const seedRequirements = requiringTests[0]?.commands.requirements ?? {
+            unit: [],
+            component: [],
+            integration: [],
+            api: [],
+        };
+        const discoveredSeedCommands = dedupeCommands(requiringTests.flatMap((item) => item.commands.discoveredCommands));
+        const seedCommands = discoveredSeedCommands.length > 0 ? discoveredSeedCommands : [FALLBACK_BOOTSTRAP_COMMAND];
+        if (!runAllScriptPath) {
+            if (!dryRun) {
+                if (commitEnabled) {
+                    const branchPrep = await this.ensureBaseBranchForCommit(baseBranch);
+                    if (branchPrep.branch) {
+                        commitBranch = branchPrep.branch;
+                    }
+                    else if (branchPrep.warning) {
+                        warnings.push(branchPrep.warning);
+                    }
+                }
+                const scriptPath = path.join(this.workspace.workspaceRoot, "tests", "all.js");
+                await PathHelper.ensureDir(path.dirname(scriptPath));
+                const seedCategory = pickSeedTestCategory(seedRequirements);
+                const contents = buildRunAllTestsScript(seedCategory, seedCommands);
+                await fs.promises.writeFile(scriptPath, contents, "utf8");
+                createdFiles.push("tests/all.js");
+                runAllScriptPath = "tests/all.js";
+            }
+            else {
+                warnings.push("Dry-run: add-tests would create tests/all.js.");
+            }
+            runAllCommand = buildRunAllTestsCommand("tests/all.js");
+            if (discoveredSeedCommands.length === 0) {
+                warnings.push("No stack-specific test commands were discovered; created a placeholder run-all harness. Replace tests/all.js commands with real suites.");
+            }
+        }
+        for (const item of requiringTests) {
+            const metadata = (item.entry.task.metadata ?? {});
+            const existingCommands = item.commands.existingCommands;
+            const fallbackCommands = item.commands.discoveredCommands.length > 0
+                ? item.commands.discoveredCommands
+                : runAllCommand
+                    ? [runAllCommand]
+                    : [];
+            const resolvedCommands = dedupeCommands(existingCommands.length > 0 ? existingCommands : fallbackCommands);
+            if (resolvedCommands.length === 0) {
+                skippedTaskKeys.push(item.entry.task.key);
+                continue;
+            }
+            const nextMetadata = stripHarnessBlocker({
+                ...metadata,
+                tests: resolvedCommands,
+                testCommands: resolvedCommands,
+            });
+            const before = JSON.stringify(metadata);
+            const after = JSON.stringify(nextMetadata);
+            if (before !== after) {
+                if (!dryRun) {
+                    await this.workspaceRepo.updateTask(item.entry.task.id, { metadata: nextMetadata });
+                }
+                updatedTaskKeys.push(item.entry.task.key);
+            }
+        }
+        if (commitEnabled && createdFiles.includes("tests/all.js")) {
+            try {
+                await this.vcs.stage(this.workspace.workspaceRoot, ["tests/all.js"]);
+                await this.vcs.commit(this.workspace.workspaceRoot, "chore(mcoda): bootstrap test harness");
+                commitSha = await this.vcs.lastCommitSha(this.workspace.workspaceRoot);
+            }
+            catch (error) {
+                warnings.push(`add-tests commit failed: ${error.message}`);
+            }
+        }
+        return {
+            projectKey: request.projectKey,
+            selectedTaskKeys,
+            tasksRequiringTests,
+            updatedTaskKeys,
+            skippedTaskKeys,
+            createdFiles,
+            runAllScriptPath,
+            runAllCommand,
+            branch: commitBranch,
+            commitSha,
+            warnings,
+        };
+    }
+}

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

@@ -41,7 +41,7 @@ export interface WorkOnTasksResult {
     results: TaskExecutionResult[];
     warnings: string[];
 }
-export type MissingTestsPolicy = "block_job" | "skip_task" | "fail_task";
+export type MissingTestsPolicy = "block_job" | "skip_task" | "fail_task" | "continue_task";
 export type ExecutionContextPolicy = "best_effort" | "require_any" | "require_sds_or_openapi";
 export declare class WorkOnTasksService {
     private workspace;

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":"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"}
+{"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;AAGzD,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;IAC5B,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;CACjD;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,GAAG,eAAe,CAAC;AAC3F,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,aAAa,GAAG,wBAAwB,CAAC;AA2tC9F,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;IAc7B,OAAO,CAAC,6BAA6B;YAuBvB,+BAA+B;YAwC/B,gBAAgB;IAwJ9B,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;CA2nG3E"}

package/dist/services/execution/WorkOnTasksService.js

@@ -12,6 +12,7 @@ import { JobService } from "../jobs/JobService.js";
 import { TaskSelectionService } from "./TaskSelectionService.js";
 import { TaskStateService } from "./TaskStateService.js";
 import { QaTestCommandBuilder } from "./QaTestCommandBuilder.js";
+import { AddTestsService } from "./AddTestsService.js";
 import { RoutingService } from "../agents/RoutingService.js";
 import { GATEWAY_HANDOFF_ENV_PATH } from "../agents/GatewayHandoff.js";
 import { AgentRatingService } from "../agents/AgentRatingService.js";
@@ -833,13 +834,22 @@ const splitFileBlocksByExistence = (fileBlocks, cwd) => {
     }
     return { existing, remaining };
 };
-const DEFAULT_MISSING_TESTS_POLICY = "block_job";
+const DEFAULT_MISSING_TESTS_POLICY = "continue_task";
 const DEFAULT_EXECUTION_CONTEXT_POLICY = "best_effort";
 const normalizeMissingTestsPolicy = (value) => {
     if (typeof value !== "string")
         return undefined;
     const normalized = value.trim().toLowerCase().replace(/-/g, "_");
-    if (normalized === "block_job" || normalized === "skip_task" || normalized === "fail_task") {
+    if (normalized === "block_job" ||
+        normalized === "skip_task" ||
+        normalized === "fail_task" ||
+        normalized === "continue_task" ||
+        normalized === "continue" ||
+        normalized === "allow" ||
+        normalized === "warn_task") {
+        if (normalized === "continue" || normalized === "allow" || normalized === "warn_task") {
+            return "continue_task";
+        }
         return normalized;
     }
     return undefined;
@@ -3489,7 +3499,12 @@ export class WorkOnTasksService {
         const enforceCommentBacklog = isCommentBacklogEnforced();
         const commentBacklogMaxFails = resolveCommentBacklogMaxFails();
         const requestedMissingTestsPolicy = normalizeMissingTestsPolicy(request.missingTestsPolicy);
-        const missingTestsPolicy = requestedMissingTestsPolicy ?? (request.allowMissingTests ? "skip_task" : DEFAULT_MISSING_TESTS_POLICY);
+        const missingTestsPolicy = requestedMissingTestsPolicy ??
+            (request.allowMissingTests === true
+                ? "continue_task"
+                : request.allowMissingTests === false
+                    ? "block_job"
+                    : DEFAULT_MISSING_TESTS_POLICY);
         const requestedExecutionContextPolicy = normalizeExecutionContextPolicy(request.executionContextPolicy);
         const executionContextPolicy = requestedExecutionContextPolicy ?? DEFAULT_EXECUTION_CONTEXT_POLICY;
         const baseCodaliEnvOverrides = codaliRequired ? buildCodaliEnvOverrides() : {};
@@ -3675,15 +3690,74 @@ export class WorkOnTasksService {
             warnings.push(...selection.warnings);
             const results = [];
             const taskSummaries = new Map();
+            let preflightMissingHarnessTasks = await this.findMissingTestHarnessTasks(selection.ordered);
+            if (preflightMissingHarnessTasks.length > 0 && !request.dryRun) {
+                const bootstrapProjectKey = selection.project?.key ?? request.projectKey;
+                if (!bootstrapProjectKey) {
+                    warnings.push("add-tests bootstrap skipped: project key could not be resolved.");
+                }
+                else {
+                    try {
+                        const addTestsService = new AddTestsService(this.workspace, {
+                            workspaceRepo: this.deps.workspaceRepo,
+                            selectionService: this.selectionService,
+                            vcsClient: this.vcs,
+                        });
+                        const bootstrap = await addTestsService.addTests({
+                            projectKey: bootstrapProjectKey,
+                            taskKeys: preflightMissingHarnessTasks.map((issue) => issue.taskKey),
+                            ignoreStatusFilter: true,
+                            ignoreDependencies: true,
+                            dryRun: false,
+                            commit: !(request.noCommit ?? false),
+                            baseBranch,
+                        });
+                        if (bootstrap.createdFiles.length > 0) {
+                            warnings.push(`add-tests bootstrap created: ${bootstrap.createdFiles.join(", ")}`);
+                        }
+                        if (bootstrap.commitSha) {
+                            warnings.push(`add-tests bootstrap commit: ${bootstrap.commitSha}${bootstrap.branch ? ` on ${bootstrap.branch}` : ""}`);
+                        }
+                        warnings.push(...bootstrap.warnings.map((warning) => `add-tests: ${warning}`));
+                        await this.checkpoint(job.id, "tests_bootstrap", {
+                            createdFiles: bootstrap.createdFiles,
+                            updatedTaskKeys: bootstrap.updatedTaskKeys,
+                            skippedTaskKeys: bootstrap.skippedTaskKeys,
+                            commitSha: bootstrap.commitSha ?? null,
+                            branch: bootstrap.branch ?? null,
+                        });
+                        const refreshedRows = await this.deps.workspaceRepo.getTasksByIds(selection.ordered.map((entry) => entry.task.id));
+                        const refreshedById = new Map(refreshedRows.map((row) => [row.id, row]));
+                        selection = {
+                            ...selection,
+                            ordered: selection.ordered.map((entry) => {
+                                const refreshed = refreshedById.get(entry.task.id);
+                                if (!refreshed)
+                                    return entry;
+                                return {
+                                    ...entry,
+                                    task: {
+                                        ...entry.task,
+                                        metadata: refreshed.metadata,
+                                    },
+                                };
+                            }),
+                        };
+                    }
+                    catch (error) {
+                        warnings.push(`add-tests bootstrap failed: ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                }
+                preflightMissingHarnessTasks = await this.findMissingTestHarnessTasks(selection.ordered);
+            }
             if (missingTestsPolicy === "block_job") {
-                const missingHarnessTasks = await this.findMissingTestHarnessTasks(selection.ordered);
-                if (missingHarnessTasks.length > 0) {
-                    const taskKeys = missingHarnessTasks.map((issue) => issue.taskKey);
+                if (preflightMissingHarnessTasks.length > 0) {
+                    const taskKeys = preflightMissingHarnessTasks.map((issue) => issue.taskKey);
                     await this.checkpoint(job.id, "tests_preflight_blocked", {
                         reason: "missing_test_harness",
                         policy: missingTestsPolicy,
                         taskKeys,
-                        issues: missingHarnessTasks.map((issue) => ({
+                        issues: preflightMissingHarnessTasks.map((issue) => ({
                             taskKey: issue.taskKey,
                             testRequirements: issue.testRequirements,
                             attemptedCommands: issue.attemptedCommands,
@@ -4212,18 +4286,26 @@ export class WorkOnTasksService {
                                 await emitTaskEndOnce();
                                 throw new Error(`missing_test_harness: ${task.task.key} requires tests but no runnable test commands were found`);
                             }
-                            await this.logTask(taskRun.id, "Tests required but no runnable test commands were found; failing task.", "tests", { testRequirements, missingTestsPolicy });
-                            await this.stateService.markFailed(task.task, "tests_not_configured", statusContext);
-                            await this.deps.workspaceRepo.updateTaskRun(taskRun.id, {
-                                status: "failed",
-                                finishedAt: new Date().toISOString(),
-                            });
-                            setFailureReason("tests_not_configured");
-                            results.push({ taskKey: task.task.key, status: "failed", notes: "tests_not_configured" });
-                            taskStatus = "failed";
-                            await this.deps.jobService.updateJobStatus(job.id, "running", { processedItems: index + 1 });
-                            await emitTaskEndOnce();
-                            continue taskLoop;
+                            if (missingTestsPolicy === "continue_task") {
+                                const warning = `Task ${task.task.key}: tests required but no runnable test harness was found; proceeding without automated tests.` +
+                                    " Add metadata.tests/testCommands or tests/all.js.";
+                                warnings.push(warning);
+                                await this.logTask(taskRun.id, "Tests required but no runnable test commands were found; continuing without automated tests due to missing-tests policy.", "tests", { testRequirements, missingTestsPolicy });
+                            }
+                            else {
+                                await this.logTask(taskRun.id, "Tests required but no runnable test commands were found; failing task.", "tests", { testRequirements, missingTestsPolicy });
+                                await this.stateService.markFailed(task.task, "tests_not_configured", statusContext);
+                                await this.deps.workspaceRepo.updateTaskRun(taskRun.id, {
+                                    status: "failed",
+                                    finishedAt: new Date().toISOString(),
+                                });
+                                setFailureReason("tests_not_configured");
+                                results.push({ taskKey: task.task.key, status: "failed", notes: "tests_not_configured" });
+                                taskStatus = "failed";
+                                await this.deps.jobService.updateJobStatus(job.id, "running", { processedItems: index + 1 });
+                                await emitTaskEndOnce();
+                                continue taskLoop;
+                            }
                         }
                         const shouldRunTests = !request.dryRun && (testsRequired ? hasRunnableTests : testCommands.length > 0);
                         let mergeConflicts = [];

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

@@ -105,6 +105,8 @@ export declare class CreateTasksService {
     private parseEpics;
     private generateStoriesForEpic;
     private generateTasksForStory;
+    private buildFallbackStoryForEpic;
+    private buildFallbackTasksForStory;
     private generatePlanFromAgent;
     private writePlanArtifacts;
     private persistPlanToDb;

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

@@ -2360,6 +2360,71 @@ export class CreateTasksService {
         })
             .filter((t) => t.title);
     }
+    buildFallbackStoryForEpic(epic) {
+        const criteria = epic.acceptanceCriteria?.filter(Boolean) ?? [];
+        return {
+            localId: "us-fallback-1",
+            title: `Deliver ${epic.title}`,
+            userStory: `As a delivery team, we need an executable implementation story for ${epic.title}.`,
+            description: [
+                `Deterministic fallback story generated because model output for epic "${epic.title}" could not be parsed reliably.`,
+                "Use SDS and related docs to decompose this story into concrete implementation tasks.",
+            ].join("\n"),
+            acceptanceCriteria: criteria.length > 0
+                ? criteria
+                : [
+                    "Story has actionable implementation tasks.",
+                    "Dependencies are explicit and story-scoped.",
+                    "Tasks are ready for execution.",
+                ],
+            relatedDocs: epic.relatedDocs ?? [],
+            priorityHint: 1,
+            tasks: [],
+        };
+    }
+    buildFallbackTasksForStory(story) {
+        const criteriaLines = (story.acceptanceCriteria ?? [])
+            .slice(0, 6)
+            .map((criterion) => `- ${criterion}`)
+            .join("\n");
+        return [
+            {
+                localId: "t-fallback-1",
+                title: `Fallback planning for ${story.title}`,
+                type: "chore",
+                description: [
+                    `Draft a concrete implementation plan for story "${story.title}" using SDS/OpenAPI context.`,
+                    "List exact files/modules to touch and implementation order.",
+                    criteriaLines ? `Acceptance criteria to satisfy:\n${criteriaLines}` : "Acceptance criteria: use story definition.",
+                ].join("\n"),
+                estimatedStoryPoints: 2,
+                priorityHint: 1,
+                dependsOnKeys: [],
+                relatedDocs: story.relatedDocs ?? [],
+                unitTests: [],
+                componentTests: [],
+                integrationTests: [],
+                apiTests: [],
+            },
+            {
+                localId: "t-fallback-2",
+                title: `Fallback implementation for ${story.title}`,
+                type: "feature",
+                description: [
+                    `Implement story "${story.title}" according to the fallback planning task.`,
+                    "Ensure done criteria and test requirements are explicitly documented for execution.",
+                ].join("\n"),
+                estimatedStoryPoints: 3,
+                priorityHint: 2,
+                dependsOnKeys: ["t-fallback-1"],
+                relatedDocs: story.relatedDocs ?? [],
+                unitTests: [],
+                componentTests: [],
+                integrationTests: [],
+                apiTests: [],
+            },
+        ];
+    }
     async generatePlanFromAgent(epics, agent, docSummary, options) {
         const planEpics = epics.map((epic, idx) => ({
             ...epic,
@@ -2367,20 +2432,56 @@ export class CreateTasksService {
         }));
         const planStories = [];
         const planTasks = [];
+        const fallbackStoryScopes = new Set();
         for (const epic of planEpics) {
-            const stories = await this.generateStoriesForEpic(agent, { ...epic }, docSummary, options.projectBuildMethod, options.agentStream, options.jobId, options.commandRunId);
-            const limitedStories = stories.slice(0, options.maxStoriesPerEpic ?? stories.length);
+            let stories = [];
+            let usedFallbackStories = false;
+            try {
+                stories = await this.generateStoriesForEpic(agent, { ...epic }, docSummary, options.projectBuildMethod, options.agentStream, options.jobId, options.commandRunId);
+            }
+            catch (error) {
+                usedFallbackStories = true;
+                await this.jobService.appendLog(options.jobId, `Story generation failed for epic "${epic.title}". Using deterministic fallback story. Reason: ${error.message ?? String(error)}\n`);
+                stories = [this.buildFallbackStoryForEpic(epic)];
+            }
+            let limitedStories = stories.slice(0, options.maxStoriesPerEpic ?? stories.length);
+            if (limitedStories.length === 0) {
+                usedFallbackStories = true;
+                await this.jobService.appendLog(options.jobId, `Story generation returned no stories for epic "${epic.title}". Using deterministic fallback story.\n`);
+                limitedStories = [this.buildFallbackStoryForEpic(epic)];
+            }
             limitedStories.forEach((story, idx) => {
-                planStories.push({
+                const planStory = {
                     ...story,
                     localId: story.localId ?? `us${idx + 1}`,
                     epicLocalId: epic.localId,
-                });
+                };
+                planStories.push(planStory);
+                if (usedFallbackStories) {
+                    fallbackStoryScopes.add(this.storyScopeKey(planStory.epicLocalId, planStory.localId));
+                }
             });
         }
         for (const story of planStories) {
-            const tasks = await this.generateTasksForStory(agent, { key: story.epicLocalId, title: story.title }, story, docSummary, options.projectBuildMethod, options.agentStream, options.jobId, options.commandRunId);
-            const limitedTasks = tasks.slice(0, options.maxTasksPerStory ?? tasks.length);
+            const storyScope = this.storyScopeKey(story.epicLocalId, story.localId);
+            let tasks = [];
+            if (fallbackStoryScopes.has(storyScope)) {
+                tasks = this.buildFallbackTasksForStory(story);
+            }
+            else {
+                try {
+                    tasks = await this.generateTasksForStory(agent, { key: story.epicLocalId, title: story.title }, story, docSummary, options.projectBuildMethod, options.agentStream, options.jobId, options.commandRunId);
+                }
+                catch (error) {
+                    await this.jobService.appendLog(options.jobId, `Task generation failed for story "${story.title}" (${storyScope}). Using deterministic fallback tasks. Reason: ${error.message ?? String(error)}\n`);
+                    tasks = this.buildFallbackTasksForStory(story);
+                }
+            }
+            let limitedTasks = tasks.slice(0, options.maxTasksPerStory ?? tasks.length);
+            if (limitedTasks.length === 0) {
+                await this.jobService.appendLog(options.jobId, `Task generation returned no tasks for story "${story.title}" (${storyScope}). Using deterministic fallback tasks.\n`);
+                limitedTasks = this.buildFallbackTasksForStory(story).slice(0, options.maxTasksPerStory ?? Number.MAX_SAFE_INTEGER);
+            }
             limitedTasks.forEach((task, idx) => {
                 planTasks.push({
                     ...task,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcoda/core",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "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/shared": "0.1.20",
-    "@mcoda/db": "0.1.20",
-    "@mcoda/agents": "0.1.20",
-    "@mcoda/generators": "0.1.20",
-    "@mcoda/integrations": "0.1.20"
+    "@mcoda/db": "0.1.22",
+    "@mcoda/agents": "0.1.22",
+    "@mcoda/generators": "0.1.22",
+    "@mcoda/integrations": "0.1.22",
+    "@mcoda/shared": "0.1.22"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",