@mcoda/core 0.1.8 → 0.1.11

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

@@ -14,11 +14,13 @@ export interface FollowupSuggestion {
     testName?: string;
     evidenceUrl?: string;
     artifacts?: string[];
+    followupSlug?: string;
 }
 export declare class QaFollowupService {
     private workspaceRepo;
     private workspaceRoot;
     constructor(workspaceRepo: WorkspaceRepository, workspaceRoot: string);
+    private get mcodaDir();
     private get cachePath();
     private readCache;
     private writeCache;

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

@@ -1 +1 @@
-{"version":3,"file":"QaFollowupService.d.ts","sourceRoot":"","sources":["../../../src/services/execution/QaFollowupService.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,OAAO,EACP,mBAAmB,EACpB,MAAM,WAAW,CAAC;AAMnB,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAgCD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,aAAa;IAAuB,OAAO,CAAC,aAAa;gBAAzD,aAAa,EAAE,mBAAmB,EAAU,aAAa,EAAE,MAAM;IAErF,OAAO,KAAK,SAAS,GAEpB;YAEa,SAAS;YAST,UAAU;YAKV,kBAAkB;IA+C1B,kBAAkB,CACtB,UAAU,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAC7D,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,GAAG;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;QAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;YA6EnG,sBAAsB;CA+ErC"}
+{"version":3,"file":"QaFollowupService.d.ts","sourceRoot":"","sources":["../../../src/services/execution/QaFollowupService.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,OAAO,EACP,mBAAmB,EACpB,MAAM,WAAW,CAAC;AAMnB,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAgCD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,aAAa;IAAuB,OAAO,CAAC,aAAa;gBAAzD,aAAa,EAAE,mBAAmB,EAAU,aAAa,EAAE,MAAM;IAErF,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,SAAS,GAEpB;YAEa,SAAS;YAST,UAAU;YAKV,kBAAkB;IA+C1B,kBAAkB,CACtB,UAAU,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAC7D,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,GAAG;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;QAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;YAiFnG,sBAAsB;CA+ErC"}

package/dist/services/execution/QaFollowupService.js

@@ -30,8 +30,11 @@ export class QaFollowupService {
         this.workspaceRepo = workspaceRepo;
         this.workspaceRoot = workspaceRoot;
     }
+    get mcodaDir() {
+        return PathHelper.getWorkspaceDir(this.workspaceRoot);
+    }
     get cachePath() {
-        return path.join(this.workspaceRoot, '.mcoda', 'qa-containers.json');
+        return path.join(this.mcodaDir, 'qa-containers.json');
     }
     async readCache() {
         try {
@@ -94,9 +97,13 @@ export class QaFollowupService {
         const keyGen = createTaskKeyGenerator(storyKeyBase, existingKeys);
         const followupKey = keyGen();
         const now = new Date().toISOString();
+        const storyPoints = suggestion.storyPoints ?? 1;
+        const boundedPoints = Math.min(10, Math.max(1, Math.round(storyPoints)));
         const metadata = {
             tags: ['qa-found', 'auto-created', 'ready-for-ai-dev', 'source=qa', ...(suggestion.tags ?? [])],
             source_task: sourceTask.key,
+            complexity: boundedPoints,
+            ...(suggestion.followupSlug ? { qa_followup_slug: suggestion.followupSlug } : {}),
             ...(suggestion.components ? { components: suggestion.components } : {}),
             ...(suggestion.docLinks ? { doc_links: suggestion.docLinks } : {}),
             ...(suggestion.testName ? { failing_test: suggestion.testName } : {}),
@@ -123,7 +130,7 @@ export class QaFollowupService {
             description,
             type: suggestion.type ?? 'bug',
             status: 'not_started',
-            storyPoints: suggestion.storyPoints ?? 1,
+            storyPoints: boundedPoints,
             priority: suggestion.priority ?? 99,
             metadata,
         };

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

@@ -0,0 +1,10 @@
+import { QaTaskPlan } from '@mcoda/shared';
+type NormalizedQaPlan = {
+    taskProfiles: Record<string, string[]>;
+    taskPlans: Record<string, QaTaskPlan>;
+    notes?: string;
+    warnings: string[];
+};
+export declare const normalizeQaPlanOutput: (value: unknown) => NormalizedQaPlan;
+export {};
+//# sourceMappingURL=QaPlanValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QaPlanValidator.d.ts","sourceRoot":"","sources":["../../../src/services/execution/QaPlanValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,UAAU,EAAE,MAAM,eAAe,CAAC;AAGnD,KAAK,gBAAgB,GAAG;IACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAwGF,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,gBAoCtD,CAAC"}

package/dist/services/execution/QaPlanValidator.js

@@ -0,0 +1,128 @@
+const toStringList = (value) => {
+    if (typeof value === 'string')
+        return value.trim() ? [value.trim()] : [];
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .filter((entry) => typeof entry === 'string')
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+};
+const ASSERT_TEXT_OK_MARKER = '__MCODA_ASSERT_OK__';
+const buildAssertTextExpression = (params) => {
+    const textExpression = params.selector
+        ? `(() => { const el = document.querySelector(${JSON.stringify(params.selector)}); return el ? (el.innerText || el.textContent || '') : ''; })()`
+        : `document.body ? (document.body.innerText || document.body.textContent || '') : ''`;
+    const expected = JSON.stringify(params.text);
+    const comparison = params.contains ? 'actual.includes(expected)' : 'actual.trim() === expected';
+    return `(() => { const actual = ${textExpression}; const expected = ${expected}; const ok = ${comparison}; return ok ? ${JSON.stringify(ASSERT_TEXT_OK_MARKER)} : actual; })()`;
+};
+const normalizeBrowserActions = (entries, warnings, taskKey) => {
+    const actions = [];
+    const context = taskKey ? ` for ${taskKey}` : '';
+    for (const entry of entries) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const action = entry;
+        const rawType = typeof action.type === 'string' ? action.type : '';
+        if (rawType === 'assertText' || rawType === 'assert_text') {
+            const text = typeof action.text === 'string' ? action.text.trim() : '';
+            if (!text) {
+                warnings.push(`QA plan browser action ${rawType} missing text${context}.`);
+                continue;
+            }
+            const selector = typeof action.selector === 'string' ? action.selector : undefined;
+            const contains = typeof action.contains === 'boolean' ? action.contains : true;
+            actions.push({
+                type: 'script',
+                expression: buildAssertTextExpression({ selector, text, contains }),
+                expect: ASSERT_TEXT_OK_MARKER,
+            });
+            continue;
+        }
+        actions.push(action);
+    }
+    return actions;
+};
+const normalizePlanEntry = (value, warnings, taskKey) => {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const raw = value;
+    const profiles = toStringList(raw.profiles);
+    const cliCommands = toStringList(raw.cli?.commands);
+    const apiRequests = Array.isArray(raw.api?.requests)
+        ? raw.api.requests.filter((entry) => typeof entry === 'object' && entry)
+        : [];
+    const rawBrowserActions = Array.isArray(raw.browser?.actions)
+        ? raw.browser.actions.filter((entry) => typeof entry === 'object' && entry)
+        : [];
+    const browserActions = normalizeBrowserActions(rawBrowserActions, warnings, taskKey);
+    const stressApi = Array.isArray(raw.stress?.api)
+        ? raw.stress.api.filter((entry) => typeof entry === 'object' && entry)
+        : [];
+    const stressBrowser = Array.isArray(raw.stress?.browser)
+        ? raw.stress.browser.filter((entry) => typeof entry === 'object' && entry)
+        : [];
+    const plan = {};
+    if (profiles.length)
+        plan.profiles = profiles;
+    if (cliCommands.length)
+        plan.cli = { commands: cliCommands };
+    if (apiRequests.length || typeof raw.api?.base_url === 'string') {
+        plan.api = {
+            base_url: typeof raw.api?.base_url === 'string' ? raw.api.base_url : undefined,
+            requests: apiRequests,
+        };
+    }
+    if (browserActions.length || typeof raw.browser?.base_url === 'string') {
+        plan.browser = {
+            base_url: typeof raw.browser?.base_url === 'string' ? raw.browser.base_url : undefined,
+            actions: browserActions.length ? browserActions : undefined,
+        };
+    }
+    if (stressApi.length || stressBrowser.length) {
+        plan.stress = {
+            api: stressApi,
+            browser: stressBrowser,
+        };
+    }
+    return Object.keys(plan).length ? plan : undefined;
+};
+export const normalizeQaPlanOutput = (value) => {
+    const warnings = [];
+    if (!value || typeof value !== 'object') {
+        warnings.push('QA plan output is not an object.');
+        return { taskProfiles: {}, taskPlans: {}, warnings };
+    }
+    const raw = value;
+    const taskProfilesRaw = raw.task_profiles ?? raw.taskProfiles;
+    const taskPlansRaw = raw.task_plans ?? raw.taskPlans ?? raw.tasks;
+    const taskProfiles = {};
+    if (taskProfilesRaw && typeof taskProfilesRaw === 'object') {
+        for (const [key, entry] of Object.entries(taskProfilesRaw)) {
+            const list = toStringList(entry);
+            if (list.length)
+                taskProfiles[key] = list;
+        }
+    }
+    else if (taskProfilesRaw !== undefined) {
+        warnings.push('QA plan task_profiles is not an object.');
+    }
+    const taskPlans = {};
+    if (taskPlansRaw && typeof taskPlansRaw === 'object') {
+        for (const [key, entry] of Object.entries(taskPlansRaw)) {
+            const normalized = normalizePlanEntry(entry, warnings, key);
+            if (normalized)
+                taskPlans[key] = normalized;
+        }
+    }
+    else if (taskPlansRaw !== undefined) {
+        warnings.push('QA plan task_plans is not an object.');
+    }
+    return {
+        taskProfiles,
+        taskPlans,
+        notes: typeof raw.notes === 'string' ? raw.notes : undefined,
+        warnings,
+    };
+};

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

@@ -4,12 +4,34 @@ export interface QaProfileResolutionOptions {
     profileName?: string;
     level?: string;
     defaultLevel?: string;
+    runnerPreference?: 'cli' | 'chromium' | 'maestro';
 }
+type QaRunner = 'cli' | 'chromium' | 'maestro';
 export declare class QaProfileService {
     private workspaceRoot;
     private cache?;
+    private webInterfaceCache?;
     private routingCache?;
-    constructor(workspaceRoot: string);
+    private noRepoWrites;
+    constructor(workspaceRoot: string, options?: {
+        noRepoWrites?: boolean;
+    });
+    private get mcodaDir();
+    private fileExists;
+    private readPackageJson;
+    private detectWebInterface;
+    private detectUiTask;
+    private detectMobileTask;
+    private resolveRunnerPlan;
+    getRunnerPlan(task: TaskRow & {
+        metadata?: any;
+    }): Promise<{
+        runners: QaRunner[];
+        hasWebInterface: boolean;
+        uiTask: boolean;
+        mobileTask: boolean;
+    }>;
+    private resolveRunnerPreference;
     private get profilePath();
     private get workspaceConfigPath();
     private getConfiguredDefaultProfileName;
@@ -18,5 +40,9 @@ export declare class QaProfileService {
     resolveProfileForTask(task: TaskRow & {
         metadata?: any;
     }, options?: QaProfileResolutionOptions): Promise<QaProfile | undefined>;
+    resolveProfilesForTask(task: TaskRow & {
+        metadata?: any;
+    }, options?: QaProfileResolutionOptions): Promise<QaProfile[]>;
 }
+export {};
 //# sourceMappingURL=QaProfileService.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"QaProfileService.d.ts","sourceRoot":"","sources":["../../../src/services/execution/QaProfileService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG1D,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,gBAAgB;IASf,OAAO,CAAC,aAAa;IARjC,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAC,CAKnB;gBAEkB,aAAa,EAAE,MAAM;IAEzC,OAAO,KAAK,WAAW,GAEtB;IAED,OAAO,KAAK,mBAAmB,GAE9B;YAEa,+BAA+B;YAU/B,gBAAgB;IAwBxB,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAyBpC,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,EAAE,OAAO,GAAE,0BAA+B,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;CAqE1I"}
+{"version":3,"file":"QaProfileService.d.ts","sourceRoot":"","sources":["../../../src/services/execution/QaProfileService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAI1D,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;CACnD;AAED,KAAK,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;AAc/C,qBAAa,gBAAgB;IAWf,OAAO,CAAC,aAAa;IAVjC,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,iBAAiB,CAAC,CAAU;IACpC,OAAO,CAAC,YAAY,CAAC,CAKnB;IACF,OAAO,CAAC,YAAY,CAAU;gBAEV,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO;IAInF,OAAO,KAAK,QAAQ,GAEnB;YAEa,UAAU;YASV,eAAe;YAUf,kBAAkB;IAyDhC,OAAO,CAAC,YAAY;IAwGpB,OAAO,CAAC,gBAAgB;YAqBV,iBAAiB;IAezB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC;QAC/D,OAAO,EAAE,QAAQ,EAAE,CAAC;QACpB,eAAe,EAAE,OAAO,CAAC;QACzB,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;YAIY,uBAAuB;IAQrC,OAAO,KAAK,WAAW,GAEtB;IAED,OAAO,KAAK,mBAAmB,GAE9B;YAEa,+BAA+B;YAU/B,gBAAgB;IAwBxB,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IA2BpC,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,EAAE,OAAO,GAAE,0BAA+B,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAoGnI,sBAAsB,CAC1B,IAAI,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,EAClC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,SAAS,EAAE,CAAC;CA8DxB"}

package/dist/services/execution/QaProfileService.js

@@ -1,15 +1,263 @@
 import path from 'node:path';
 import { PathHelper } from '@mcoda/shared';
+import { classifyTask } from '../backlog/TaskOrderingHeuristics.js';
 import fs from 'node:fs/promises';
+const DEFAULT_QA_PROFILES = [
+    {
+        name: 'cli',
+        runner: 'cli',
+        default: true,
+    },
+    {
+        name: 'chromium',
+        runner: 'chromium',
+    },
+];
 export class QaProfileService {
-    constructor(workspaceRoot) {
+    constructor(workspaceRoot, options = {}) {
         this.workspaceRoot = workspaceRoot;
+        this.noRepoWrites = Boolean(options.noRepoWrites);
+    }
+    get mcodaDir() {
+        return PathHelper.getWorkspaceDir(this.workspaceRoot);
+    }
+    async fileExists(targetPath) {
+        try {
+            await fs.access(targetPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async readPackageJson() {
+        const pkgPath = path.join(this.workspaceRoot, 'package.json');
+        try {
+            const raw = await fs.readFile(pkgPath, 'utf8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async detectWebInterface() {
+        if (this.webInterfaceCache !== undefined)
+            return this.webInterfaceCache;
+        const markers = [
+            'client',
+            'frontend',
+            'web',
+            'ui',
+            'apps/web',
+            'apps/client',
+            'packages/web',
+            'packages/client',
+            'src/public',
+            'src/public/index.html',
+            'public/index.html',
+            'index.html',
+            'src/App.tsx',
+            'src/main.tsx',
+            'src/App.jsx',
+            'src/main.jsx',
+            'next.config.js',
+            'next.config.mjs',
+            'vite.config.ts',
+            'vite.config.js',
+            'svelte.config.js',
+            'angular.json',
+            'nuxt.config.js',
+            'astro.config.mjs',
+            'remix.config.js',
+        ];
+        for (const marker of markers) {
+            if (await this.fileExists(path.join(this.workspaceRoot, marker))) {
+                this.webInterfaceCache = true;
+                return true;
+            }
+        }
+        const pkg = await this.readPackageJson();
+        const deps = {
+            ...(pkg?.dependencies ?? {}),
+            ...(pkg?.devDependencies ?? {}),
+            ...(pkg?.peerDependencies ?? {}),
+        };
+        const uiDeps = [
+            'react',
+            'next',
+            'vue',
+            'nuxt',
+            'svelte',
+            'astro',
+            '@angular/core',
+            '@remix-run/react',
+            'solid-js',
+        ];
+        const hasUiDep = uiDeps.some((dep) => typeof deps?.[dep] === 'string');
+        this.webInterfaceCache = hasUiDep;
+        return hasUiDep;
+    }
+    detectUiTask(task) {
+        const metadata = task.metadata ?? {};
+        const files = Array.isArray(metadata.files) ? metadata.files : [];
+        const reviewFiles = Array.isArray(metadata.last_review_changed_paths)
+            ? metadata.last_review_changed_paths
+            : [];
+        const key = String(task.key ?? '').toLowerCase();
+        const isUiKey = key.startsWith('web-') ||
+            key.startsWith('ui-') ||
+            key.startsWith('fe-') ||
+            key.startsWith('ux-') ||
+            key.includes('-web-') ||
+            key.includes('-ui-') ||
+            key.includes('-fe-') ||
+            key.includes('-ux-');
+        if (isUiKey)
+            return true;
+        const isBackendKey = key.startsWith('bck-') ||
+            key.startsWith('backend-') ||
+            key.startsWith('api-') ||
+            key.startsWith('ops-') ||
+            key.startsWith('infra-') ||
+            key.includes('-bck-') ||
+            key.includes('-backend-') ||
+            key.includes('-api-') ||
+            key.includes('-ops-') ||
+            key.includes('-infra-');
+        const tags = Array.isArray(metadata.tags)
+            ? metadata.tags.map((tag) => String(tag).toLowerCase())
+            : [];
+        const tagHints = new Set(['ui', 'ux', 'frontend', 'front-end', 'web', 'client']);
+        const hasUiTag = tags.some((tag) => tagHints.has(tag));
+        const components = Array.isArray(metadata.components)
+            ? metadata.components.map((component) => String(component).toLowerCase())
+            : [];
+        const componentHints = new Set(['ui', 'ux', 'frontend', 'front-end', 'web', 'client']);
+        const hasUiComponent = components.some((component) => componentHints.has(component));
+        const uiHints = [
+            '/ui/',
+            '/frontend/',
+            '/client/',
+            '/web/',
+            '/components/',
+            '/pages/',
+            '/app/',
+            '/public/',
+            '/styles/',
+        ];
+        const uiExtensions = ['.tsx', '.jsx', '.vue', '.svelte', '.astro', '.html', '.css', '.scss', '.less'];
+        const hasUiFileHint = (paths, options = {}) => {
+            for (const file of paths) {
+                const normalized = String(file).toLowerCase();
+                const extensionMatch = uiExtensions.some((ext) => normalized.endsWith(ext));
+                if (extensionMatch)
+                    return true;
+                if (options.requireExtension)
+                    continue;
+                if (uiHints.some((hint) => normalized.includes(hint)))
+                    return true;
+            }
+            return false;
+        };
+        const type = typeof task.type === 'string' ? task.type.toLowerCase() : '';
+        const hasUiType = ['frontend', 'front-end', 'ui', 'web', 'client'].some((hint) => type.includes(hint));
+        if (hasUiTag || hasUiComponent || hasUiType)
+            return true;
+        if (hasUiFileHint(files, { requireExtension: isBackendKey }))
+            return true;
+        if (isBackendKey)
+            return false;
+        if (hasUiFileHint(reviewFiles))
+            return true;
+        const acceptance = Array.isArray(task.acceptanceCriteria)
+            ? task.acceptanceCriteria
+            : [];
+        const text = [task.key, task.title, task.description, task.type, ...acceptance]
+            .filter(Boolean)
+            .join(' ')
+            .toLowerCase();
+        if (text) {
+            const uiPhrases = [
+                'user interface',
+                'front end',
+                'frontend',
+                'front-end',
+                'web ui',
+                'web-',
+                'ui-',
+                'ui ',
+                'page',
+                'screen',
+                'view',
+                'component',
+                'browser',
+                'html',
+                'css',
+                'responsive',
+                'accessibility',
+            ];
+            if (uiPhrases.some((phrase) => text.includes(phrase)))
+                return true;
+        }
+        const classification = classifyTask({
+            title: task.title,
+            description: task.description,
+            type: task.type ?? undefined,
+        });
+        if (classification.stage === 'frontend')
+            return true;
+        return false;
+    }
+    detectMobileTask(task) {
+        const metadata = task.metadata ?? {};
+        const tags = Array.isArray(metadata.tags) ? metadata.tags.map((t) => t.toLowerCase()) : [];
+        const type = typeof task.type === 'string' ? task.type.toLowerCase() : '';
+        const mobileTags = new Set(['mobile', 'ios', 'android', 'maestro', 'react-native', 'rn']);
+        if (tags.some((tag) => mobileTags.has(tag)))
+            return true;
+        if (mobileTags.has(type))
+            return true;
+        const files = Array.isArray(metadata.files) ? metadata.files : [];
+        const reviewFiles = Array.isArray(metadata.last_review_changed_paths)
+            ? metadata.last_review_changed_paths
+            : [];
+        const combined = [...files, ...reviewFiles];
+        const mobileHints = ['/ios/', '/android/', '/mobile/'];
+        for (const file of combined) {
+            const normalized = String(file).toLowerCase();
+            if (mobileHints.some((hint) => normalized.includes(hint)))
+                return true;
+            if (normalized.endsWith('.maestro.yml') || normalized.endsWith('.maestro.yaml'))
+                return true;
+        }
+        return false;
+    }
+    async resolveRunnerPlan(task) {
+        const hasWebInterface = await this.detectWebInterface();
+        const uiTask = this.detectUiTask(task);
+        const mobileTask = this.detectMobileTask(task);
+        const runners = ['cli'];
+        if (uiTask && hasWebInterface)
+            runners.push('chromium');
+        if (mobileTask)
+            runners.push('maestro');
+        return { runners, hasWebInterface, uiTask, mobileTask };
+    }
+    async getRunnerPlan(task) {
+        return this.resolveRunnerPlan(task);
+    }
+    async resolveRunnerPreference(task) {
+        if (task && this.detectUiTask(task)) {
+            const hasUi = await this.detectWebInterface();
+            return hasUi ? 'chromium' : 'cli';
+        }
+        return 'cli';
     }
     get profilePath() {
-        return path.join(this.workspaceRoot, '.mcoda', 'qa-profiles.json');
+        return path.join(this.mcodaDir, 'qa-profiles.json');
     }
     get workspaceConfigPath() {
-        return path.join(this.workspaceRoot, '.mcoda', 'config.json');
+        return path.join(this.mcodaDir, 'config.json');
     }
     async getConfiguredDefaultProfileName() {
         try {
@@ -44,7 +292,9 @@ export class QaProfileService {
     async loadProfiles() {
         if (this.cache)
             return this.cache;
-        await PathHelper.ensureDir(path.join(this.workspaceRoot, '.mcoda'));
+        if (!this.noRepoWrites) {
+            await PathHelper.ensureDir(this.mcodaDir);
+        }
         try {
             const raw = await fs.readFile(this.profilePath, 'utf8');
             const parsed = JSON.parse(raw);
@@ -56,12 +306,12 @@ export class QaProfileService {
                 this.cache = parsed.profiles;
                 return this.cache;
             }
-            this.cache = [];
+            this.cache = DEFAULT_QA_PROFILES;
             return this.cache;
         }
         catch (error) {
             if (error?.code === 'ENOENT') {
-                this.cache = [];
+                this.cache = DEFAULT_QA_PROFILES;
                 return this.cache;
             }
             throw error;
@@ -73,6 +323,18 @@ export class QaProfileService {
             return undefined;
         const envProfile = process.env.MCODA_QA_PROFILE;
         const routing = await this.getRoutingConfig();
+        const runnerPreference = options.runnerPreference ?? (await this.resolveRunnerPreference(task));
+        const normalizeRunner = (profile) => profile.runner ?? 'cli';
+        const matchRunner = (profile) => normalizeRunner(profile) === runnerPreference || profile.name === runnerPreference;
+        const pickByRunner = () => {
+            const matches = profiles.filter(matchRunner);
+            if (!matches.length)
+                return undefined;
+            const defaults = matches.filter((p) => p.default);
+            if (defaults.length === 1)
+                return defaults[0];
+            return matches[0];
+        };
         const configuredDefault = options.profileName ?? envProfile ?? (await this.getConfiguredDefaultProfileName()) ?? routing.defaultProfile;
         const pickByName = (name) => {
             if (!name)
@@ -85,6 +347,14 @@ export class QaProfileService {
         };
         const explicit = pickByName(configuredDefault);
         if (explicit) {
+            if (options.profileName) {
+                return explicit;
+            }
+            if (normalizeRunner(explicit) !== runnerPreference) {
+                const fallback = pickByRunner();
+                if (fallback)
+                    return fallback;
+            }
             return explicit;
         }
         const taskTags = Array.isArray(task.metadata?.tags)
@@ -107,8 +377,18 @@ export class QaProfileService {
                 : undefined;
             const routedName = levelRoute ?? typeRoute ?? tagRoute;
             const routed = pickByName(routedName);
-            if (routed)
+            if (routed) {
+                if (normalizeRunner(routed) !== runnerPreference) {
+                    const fallback = pickByRunner();
+                    if (fallback)
+                        return fallback;
+                }
                 return routed;
+            }
+        }
+        const runnerCandidates = candidates.filter(matchRunner);
+        if (runnerCandidates.length) {
+            candidates = runnerCandidates;
         }
         const targetLevel = options.level ?? options.defaultLevel;
         if (targetLevel) {
@@ -131,6 +411,9 @@ export class QaProfileService {
                 .map((p) => p.name)
                 .join(', ')}`);
         }
+        const runnerDefault = pickByRunner();
+        if (runnerDefault)
+            return runnerDefault;
         const defaults = profiles.filter((p) => p.default);
         if (defaults.length === 1)
             return defaults[0];
@@ -139,4 +422,68 @@ export class QaProfileService {
         }
         return undefined;
     }
+    async resolveProfilesForTask(task, options = {}) {
+        if (options.profileName) {
+            const explicit = await this.resolveProfileForTask(task, options);
+            return explicit ? [explicit] : [];
+        }
+        const qaProfiles = Array.isArray(task.metadata?.qa?.profiles_expected)
+            ? task.metadata.qa.profiles_expected
+                .map((value) => String(value).trim())
+                .filter(Boolean)
+            : [];
+        if (qaProfiles.length > 0) {
+            const profiles = await this.loadProfiles();
+            const byName = new Map(profiles.map((profile) => [profile.name.toLowerCase(), profile]));
+            const pickByRunner = (runner) => {
+                const matches = profiles.filter((profile) => (profile.runner ?? 'cli') === runner);
+                if (!matches.length)
+                    return undefined;
+                const defaults = matches.filter((profile) => profile.default);
+                if (defaults.length === 1)
+                    return defaults[0];
+                return matches[0];
+            };
+            const runnerAliases = {
+                api: 'cli',
+                cli: 'cli',
+                browser: 'chromium',
+                web: 'chromium',
+                ui: 'chromium',
+                chromium: 'chromium',
+                maestro: 'maestro',
+                mobile: 'maestro',
+            };
+            const resolved = [];
+            const seen = new Set();
+            for (const profileName of qaProfiles) {
+                const normalized = profileName.toLowerCase();
+                let profile = byName.get(normalized);
+                if (!profile) {
+                    const runner = runnerAliases[normalized];
+                    if (runner) {
+                        profile = pickByRunner(runner);
+                    }
+                }
+                if (profile && !seen.has(profile.name)) {
+                    resolved.push(profile);
+                    seen.add(profile.name);
+                }
+            }
+            if (resolved.length > 0) {
+                return resolved;
+            }
+        }
+        const plan = await this.resolveRunnerPlan(task);
+        const profiles = [];
+        const seen = new Set();
+        for (const runner of plan.runners) {
+            const profile = await this.resolveProfileForTask(task, { ...options, runnerPreference: runner });
+            if (profile && !seen.has(profile.name)) {
+                profiles.push(profile);
+                seen.add(profile.name);
+            }
+        }
+        return profiles;
+    }
 }