@copado/agentia-cli 0.122.0-alpha.1 → 1.0.0-beta.0

package/dist/lib/setup-wizard.js

@@ -1,593 +1,5 @@
-import { homedir } from 'node:os';
-import { normalizeAiDomain, normalizeAiOrgId } from './ai-config.js';
-import { applyAuthSet, formatCicdApiKeyHelp, formatPersonalAccessKeyHelp, getAiAuthStatus, getCicdAuthStatus, getCrtAuthStatus, } from './auth-config.js';
-import { readAuthProfile } from './auth-profile.js';
-import { normalizeCicdBaseUrl } from './cicd-gateway.js';
-import { detectCursorInstall, getCursorMcpStatus, globalCursorMcpPath, localCursorMcpPath, upsertAgentiaCursorMcp, } from './cursor-mcp-config.js';
-import { resolveProjectContext, runProjectSetup, } from './project-setup.js';
-import { createInquirerSetupPrompts } from './setup-prompts.js';
-import { runSetupSkills } from './setup-skills.js';
-import { formatTestingConfigurationFieldList, normalizeCrtDomain, normalizeCrtOrgId } from './testing-config.js';
-let testWizardDeps;
-export function setSetupWizardDepsForTests(deps) {
-    testWizardDeps = deps;
-}
-export function resetSetupWizardDepsForTests() {
-    testWizardDeps = undefined;
-}
-function resolveWizardDeps(overrides = {}) {
-    const merged = { ...testWizardDeps, ...overrides };
-    return {
-        ...merged,
-        applyAuthSet: merged.applyAuthSet ?? applyAuthSet,
-        detectCursorInstall: merged.detectCursorInstall ?? detectCursorInstall,
-        getAiAuthStatus: merged.getAiAuthStatus ?? getAiAuthStatus,
-        getCicdAuthStatus: merged.getCicdAuthStatus ?? getCicdAuthStatus,
-        getCrtAuthStatus: merged.getCrtAuthStatus ?? getCrtAuthStatus,
-        getCursorMcpStatus: merged.getCursorMcpStatus ?? getCursorMcpStatus,
-        runSetupSkills: merged.runSetupSkills ?? runSetupSkills,
-        upsertAgentiaCursorMcp: merged.upsertAgentiaCursorMcp ?? upsertAgentiaCursorMcp,
-    };
-}
-function withCursorStatus(current, action) {
-    return {
-        ...current,
-        status: action,
-    };
-}
-function logSection(log, title) {
-    log('');
-    log(title);
-}
-function formatAuthScope(source) {
-    return source === 'local' ? 'Project-scoped' : 'Global';
-}
-function formatCicdStatusLine(status) {
-    if (!status.set) {
-        if (status.local && status.baseUrl) {
-            return `CICD: not set (endpoint: ${status.baseUrl}, local)`;
-        }
-        return 'CICD: not set';
-    }
-    const endpoint = status.baseUrl ?? 'not set';
-    return `${formatAuthScope(status.source)} authentication found:\nAPI Key: ${status.masked}\nServer URL: ${endpoint}`;
-}
-function formatCrtStatusLine(status) {
-    const domain = status.domain ?? 'not set';
-    const orgId = status.orgId ?? 'not set';
-    const ready = status.ready ?? status.set;
-    if (!ready) {
-        const pak = status.masked ?? 'not set';
-        const issues = status.issues ?? [];
-        const missing = issues.filter((issue) => issue.kind === 'missing').map((issue) => issue.field);
-        const invalid = issues.filter((issue) => issue.kind === 'invalid');
-        const details = [];
-        if (missing.length > 0) {
-            details.push(`missing: ${formatTestingConfigurationFieldList(missing)}`);
-        }
-        if (invalid.length > 0) {
-            details.push(`invalid: ${invalid
-                .map((issue) => {
-                const label = formatTestingConfigurationFieldList([issue.field]);
-                return issue.message === undefined ? label : `${label} (${issue.message})`;
-            })
-                .join(', ')}`);
-        }
-        return `CRT: incomplete (Personal Access Key: ${pak}, domain: ${domain}, org: ${orgId}${details.length === 0 ? '' : `; ${details.join('; ')}`})`;
-    }
-    return `${formatAuthScope(status.source)} authentication found:\nPersonal Access Key: ${status.masked}\nDomain: ${domain}\nOrganization: ${orgId}`;
-}
-function formatAiStatusLine(status) {
-    return status.set
-        ? `${formatAuthScope(status.source)} authentication found:\nPersonal Access Key: ${status.masked}\nDomain: ${status.domain ?? 'not set'}\nOrganization: ${status.orgId ?? 'not set'}\nWorkspace: ${status.workspaceId ?? 'not set'}`
-        : `AI: not set (domain: ${status.domain ?? 'not set'}, org: ${status.orgId ?? 'not set'}, workspace: ${status.workspaceId ?? 'not set'})`;
-}
-async function configureAi(context) {
-    const { deps, log, options, prompts } = context;
-    const current = deps.getAiAuthStatus();
-    log(formatAiStatusLine(current));
-    if (options.noPrompt || prompts === undefined) {
-        return {
-            configured: current.set,
-            domain: current.domain ?? undefined,
-            orgId: current.orgId ?? undefined,
-            status: current.set ? 'unchanged' : 'skipped',
-        };
-    }
-    let shouldConfigure = await prompts.confirm({
-        default: !current.set,
-        message: setupAuthPrompt('ai', current.set),
-    });
-    let scope = hasLocalAuthProfile('ai') || current.set ? 'local' : undefined;
-    if (!shouldConfigure) {
-        shouldConfigure =
-            current.set && current.source === 'global' && !hasLocalAuthProfile('ai')
-                ? await prompts.confirm({ default: false, message: 'Reconfigure global AI authentication?' })
-                : false;
-        if (shouldConfigure)
-            scope = 'global';
-        if (!shouldConfigure) {
-            log('Skipped AI authentication.');
-            return {
-                configured: current.set,
-                domain: current.domain ?? undefined,
-                orgId: current.orgId ?? undefined,
-                status: 'skipped',
-            };
-        }
-    }
-    scope ??= await setupAuthScope('ai', false, prompts);
-    log(formatPersonalAccessKeyHelp());
-    const pak = await prompts.password({
-        message: 'AI Personal Access Key (PAK)',
-        validate: (value) => (value.trim().length > 0 ? true : 'AI Personal Access Key cannot be empty.'),
-    });
-    const domain = await prompts.input({
-        default: current.domain ?? undefined,
-        message: 'AI domain',
-        validate(value) {
-            try {
-                normalizeAiDomain(value);
-                return true;
-            }
-            catch (error) {
-                return error.message;
-            }
-        },
-    });
-    const orgRaw = await prompts.input({
-        default: current.orgId ?? undefined,
-        message: 'AI organization ID',
-        validate(value) {
-            try {
-                normalizeAiOrgId(value);
-                return true;
-            }
-            catch (error) {
-                return error.message;
-            }
-        },
-    });
-    const workspace = await prompts.input({
-        message: 'AI workspace ID (optional; press Enter to auto-create)',
-    });
-    try {
-        const result = await runWithSpinner(options, 'Validating AI credentials', () => deps.applyAuthSet({
-            ai: pak,
-            aiDomain: domain,
-            aiOrg: normalizeAiOrgId(orgRaw),
-            aiWorkspace: workspace.trim().length === 0 ? undefined : workspace,
-            scope,
-        }));
-        log(`Stored AI domain: ${result.ai?.domain ?? domain}.`);
-        return {
-            configured: true,
-            domain: result.ai?.domain ?? domain,
-            orgId: (result.ai?.orgId ?? normalizeAiOrgId(orgRaw)).toString(),
-            status: current.set ? 'updated' : 'created',
-        };
-    }
-    catch (error) {
-        log(error.message);
-        return {
-            configured: current.set,
-            domain: current.domain ?? undefined,
-            orgId: current.orgId ?? undefined,
-            status: 'failed',
-        };
-    }
-}
-async function runWithSpinner(options, message, action) {
-    if (options.withSpinner === undefined) {
-        return action();
-    }
-    return options.withSpinner(message, action);
-}
-function hasLocalAuthProfile(type) {
-    return readAuthProfile('local')?.[type] !== undefined;
-}
-async function setupAuthScope(type, globalConfigured, prompts) {
-    if (hasLocalAuthProfile(type) || globalConfigured)
-        return 'local';
-    return prompts.select({
-        choices: [
-            { name: 'Global (all projects)', value: 'global' },
-            { name: 'Project-scoped (this project)', value: 'local' },
-        ],
-        message: `Where should ${type.toUpperCase()} authentication be stored?`,
-    });
-}
-function setupAuthPrompt(type, configured) {
-    if (hasLocalAuthProfile(type))
-        return `Reconfigure project-scoped ${type.toUpperCase()} authentication?`;
-    if (configured)
-        return `Create project-scoped ${type.toUpperCase()} authentication?`;
-    return `Configure global ${type.toUpperCase()} authentication for all projects?`;
-}
-async function configureCicd(context) {
-    const { deps, log, options, prompts } = context;
-    const current = deps.getCicdAuthStatus();
-    log(formatCicdStatusLine(current));
-    if (options.noPrompt || prompts === undefined) {
-        return {
-            baseUrl: current.baseUrl ?? undefined,
-            configured: current.set,
-            status: current.set ? 'unchanged' : 'skipped',
-        };
-    }
-    let shouldConfigure = await prompts.confirm({
-        default: !current.set,
-        message: setupAuthPrompt('cicd', current.set),
-    });
-    let scope = hasLocalAuthProfile('cicd') || current.set ? 'local' : undefined;
-    if (!shouldConfigure) {
-        shouldConfigure =
-            current.set && current.source === 'global' && !hasLocalAuthProfile('cicd')
-                ? await prompts.confirm({ default: false, message: 'Reconfigure global CICD authentication?' })
-                : false;
-        if (shouldConfigure)
-            scope = 'global';
-        if (!shouldConfigure) {
-            log('Skipped CICD authentication.');
-            return {
-                baseUrl: current.baseUrl ?? undefined,
-                configured: current.set,
-                status: 'skipped',
-            };
-        }
-    }
-    scope ??= await setupAuthScope('cicd', false, prompts);
-    log(formatCicdApiKeyHelp());
-    while (true) {
-        // Sequential prompts are required to retry authentication with a new key.
-        // eslint-disable-next-line no-await-in-loop
-        const apiKey = await prompts.password({
-            message: 'Copado API key',
-            validate: (value) => (value.trim().length > 0 ? true : 'Copado API key cannot be empty.'),
-        });
-        // eslint-disable-next-line no-await-in-loop
-        const endpointMode = await prompts.select({
-            choices: [
-                { name: 'Auto-detect', value: 'auto' },
-                { name: 'Custom URL', value: 'custom' },
-            ],
-            default: 'auto',
-            message: 'CICD API URL',
-        });
-        let customUrl;
-        if (endpointMode === 'custom') {
-            // eslint-disable-next-line no-await-in-loop
-            customUrl = await prompts.input({
-                message: 'CICD custom URL',
-                validate(value) {
-                    try {
-                        normalizeCicdBaseUrl(value);
-                        return true;
-                    }
-                    catch (error) {
-                        return error.message;
-                    }
-                },
-            });
-        }
-        try {
-            // eslint-disable-next-line no-await-in-loop
-            const result = await runWithSpinner(options, endpointMode === 'custom' ? 'Validating CICD API key for custom endpoint' : 'Discovering CICD endpoint', () => deps.applyAuthSet({
-                cicd: apiKey,
-                customUrl,
-                scope,
-            }));
-            log(`Stored CICD endpoint: ${result.baseUrl}.`);
-            return {
-                baseUrl: result.baseUrl,
-                configured: true,
-                status: current.set ? 'updated' : 'created',
-            };
-        }
-        catch (error) {
-            log(error.message);
-            // eslint-disable-next-line no-await-in-loop
-            const retry = await prompts.confirm({
-                default: true,
-                message: 'CICD authentication failed. Try another API key?',
-            });
-            if (!retry) {
-                return {
-                    baseUrl: current.baseUrl ?? undefined,
-                    configured: current.set,
-                    status: 'failed',
-                };
-            }
-        }
-    }
-}
-// CRT prompts, discovery, and storage are intentionally sequential.
-// eslint-disable-next-line complexity
-async function configureCrt(context) {
-    const { deps, log, options, prompts } = context;
-    const current = deps.getCrtAuthStatus();
-    const currentReady = current.ready ?? current.set;
-    log(formatCrtStatusLine(current));
-    if (options.noPrompt || prompts === undefined) {
-        return {
-            configured: currentReady,
-            domain: current.domain ?? undefined,
-            orgId: current.orgId ?? undefined,
-            status: currentReady ? 'unchanged' : 'skipped',
-        };
-    }
-    let shouldConfigure = await prompts.confirm({
-        default: !currentReady,
-        message: setupAuthPrompt('crt', currentReady),
-    });
-    let scope = hasLocalAuthProfile('crt')
-        ? 'local'
-        : currentReady
-            ? 'local'
-            : current.source === 'global'
-                ? 'global'
-                : undefined;
-    if (!shouldConfigure) {
-        shouldConfigure =
-            currentReady && current.source === 'global' && !hasLocalAuthProfile('crt')
-                ? await prompts.confirm({ default: false, message: 'Reconfigure global CRT authentication?' })
-                : false;
-        if (shouldConfigure)
-            scope = 'global';
-        if (!shouldConfigure) {
-            log('Skipped CRT authentication.');
-            return {
-                configured: currentReady,
-                domain: current.domain ?? undefined,
-                orgId: current.orgId ?? undefined,
-                status: 'skipped',
-            };
-        }
-    }
-    scope ??= await setupAuthScope('crt', false, prompts);
-    log(formatPersonalAccessKeyHelp());
-    while (true) {
-        // Sequential prompts are required to retry authentication with new credentials.
-        // eslint-disable-next-line no-await-in-loop
-        const pat = await prompts.password({
-            message: 'CRT Personal Access Key (PAK)',
-            validate: (value) => (value.trim().length > 0 ? true : 'CRT Personal Access Key cannot be empty.'),
-        });
-        // eslint-disable-next-line no-await-in-loop
-        const orgRaw = await prompts.input({
-            default: current.orgId ?? undefined,
-            message: 'CRT organization ID',
-            validate(value) {
-                try {
-                    normalizeCrtOrgId(value);
-                    return true;
-                }
-                catch (error) {
-                    return error.message;
-                }
-            },
-        });
-        const orgId = normalizeCrtOrgId(orgRaw);
-        // eslint-disable-next-line no-await-in-loop
-        const endpointMode = await prompts.select({
-            choices: [
-                { name: 'Auto-detect', value: 'auto' },
-                { name: 'Custom domain', value: 'custom' },
-            ],
-            default: 'auto',
-            message: 'CRT domain',
-        });
-        let crtDomain;
-        if (endpointMode === 'custom') {
-            // eslint-disable-next-line no-await-in-loop
-            crtDomain = await prompts.input({
-                default: current.domain ?? undefined,
-                message: 'CRT custom domain',
-                validate(value) {
-                    try {
-                        normalizeCrtDomain(value);
-                        return true;
-                    }
-                    catch (error) {
-                        return error.message;
-                    }
-                },
-            });
-        }
-        try {
-            // eslint-disable-next-line no-await-in-loop
-            const result = await runWithSpinner(options, endpointMode === 'custom' ? 'Validating CRT credentials for custom domain' : 'Discovering CRT domain', () => deps.applyAuthSet({
-                crt: pat,
-                crtDomain,
-                crtOrg: orgId,
-                scope,
-            }));
-            const storedDomain = result.crt?.domain ?? crtDomain;
-            const storedOrgId = (result.crt?.orgId ?? orgId).toString();
-            if (storedDomain !== undefined) {
-                log(`Stored CRT domain: ${storedDomain}.`);
-            }
-            log(`Stored CRT organization ID: ${storedOrgId}.`);
-            return {
-                configured: true,
-                domain: storedDomain,
-                orgId: storedOrgId,
-                status: currentReady ? 'updated' : 'created',
-            };
-        }
-        catch (error) {
-            log(error.message);
-            // eslint-disable-next-line no-await-in-loop
-            const retry = await prompts.confirm({
-                default: true,
-                message: 'CRT authentication failed. Try another Personal Access Key?',
-            });
-            if (!retry) {
-                return {
-                    configured: currentReady,
-                    domain: current.domain ?? undefined,
-                    orgId: current.orgId ?? undefined,
-                    status: 'failed',
-                };
-            }
-        }
-    }
-}
-function cursorStatusLabel(status) {
-    if (status.configured) {
-        const name = status.serverName === undefined ? '' : ` as "${status.serverName}"`;
-        return `configured${name} (${status.path})`;
-    }
-    if (status.conflicting) {
-        return `different Agentia entry (${status.path})`;
-    }
-    if (status.exists) {
-        return `not configured (${status.path})`;
-    }
-    return `not found (${status.path})`;
-}
-async function configureCursorMcp(context, projectRoot) {
-    const { deps, log, options, prompts } = context;
-    const install = deps.detectCursorInstall();
-    const status = await deps.getCursorMcpStatus(projectRoot);
-    log(`Cursor install: ${install.detected ? 'detected' : 'not detected (advisory)'}`);
-    log(`Project MCP: ${cursorStatusLabel(status.local)}`);
-    log(`Global MCP: ${cursorStatusLabel(status.global)}`);
-    if (status.local.configured && status.global.configured) {
-        log('Agentia MCP is already configured for Cursor locally and globally.');
-        return {
-            detected: install.detected,
-            global: withCursorStatus(status.global, 'unchanged'),
-            local: withCursorStatus(status.local, 'unchanged'),
-        };
-    }
-    if (options.noPrompt || prompts === undefined) {
-        return {
-            detected: install.detected,
-            global: withCursorStatus(status.global, status.global.configured ? 'unchanged' : 'skipped'),
-            local: withCursorStatus(status.local, status.local.configured ? 'unchanged' : 'skipped'),
-        };
-    }
-    const shouldConfigure = await prompts.confirm({
-        default: !status.local.configured && !status.global.configured,
-        message: 'Configure Agentia MCP for Cursor?',
-    });
-    if (!shouldConfigure) {
-        log('Skipped Cursor MCP configuration.');
-        return {
-            detected: install.detected,
-            global: withCursorStatus(status.global, 'skipped'),
-            local: withCursorStatus(status.local, 'skipped'),
-        };
-    }
-    const scope = await prompts.select({
-        choices: [
-            { name: 'Project (.cursor/mcp.json)', value: 'local' },
-            { name: 'Global (~/.cursor/mcp.json)', value: 'global' },
-            { name: 'Both', value: 'both' },
-        ],
-        message: 'Where should Agentia MCP be configured?',
-    });
-    const writeScope = async (target, current) => {
-        if (current.configured) {
-            log(`Agentia MCP already configured (${current.path}).`);
-            return withCursorStatus(current, 'unchanged');
-        }
-        if (current.conflicting) {
-            const replace = await prompts.confirm({
-                default: false,
-                message: `Replace the existing Agentia MCP entry in ${current.path}?`,
-            });
-            if (!replace) {
-                log(`Left existing Agentia MCP entry unchanged (${current.path}).`);
-                return withCursorStatus(current, 'skipped');
-            }
-        }
-        const filePath = target === 'local' ? localCursorMcpPath(projectRoot) : globalCursorMcpPath(deps.homedir?.() ?? homedir());
-        try {
-            const written = await deps.upsertAgentiaCursorMcp(filePath);
-            log(`Agentia MCP ${written.status} at ${written.path}. Restart Cursor, then enable the Agentia server in Cursor's MCP settings if it is shown as disabled.`);
-            return {
-                configured: true,
-                conflicting: false,
-                exists: true,
-                path: written.path,
-                status: written.status,
-            };
-        }
-        catch (error) {
-            log(error.message);
-            return withCursorStatus(current, 'failed');
-        }
-    };
-    let localResult = withCursorStatus(status.local, status.local.configured ? 'unchanged' : 'skipped');
-    let globalResult = withCursorStatus(status.global, status.global.configured ? 'unchanged' : 'skipped');
-    if (scope === 'local' || scope === 'both') {
-        localResult = await writeScope('local', status.local);
-    }
-    if (scope === 'global' || scope === 'both') {
-        globalResult = await writeScope('global', status.global);
-    }
-    return {
-        detected: install.detected,
-        global: globalResult,
-        local: localResult,
-    };
-}
-function buildNextSteps(params) {
-    const steps = [];
-    if (!params.mcpConfigured) {
-        steps.push(`If you use Cursor, configure it to run \`${params.bin} mcp start\` as an MCP server.`);
-    }
-    if (steps.length === 0) {
-        steps.push(`Use \`${params.bin} cicd work list --assigned-to-me\` to start working on a user story.`);
-    }
-    return steps;
-}
-export async function runSetupWizard(options = {}, deps = {}) {
-    const resolved = resolveWizardDeps(deps);
-    const bin = options.bin ?? 'agentia';
-    const log = options.log ??
-        (() => {
-            /* no human output */
-        });
-    const noPrompt = options.noPrompt ?? false;
-    const prompts = noPrompt ? undefined : (resolved.prompts ?? createInquirerSetupPrompts());
-    const cwd = options.cwd ?? process.cwd();
-    const context = await resolveProjectContext(cwd, resolved);
-    const section = { deps: resolved, log, options, prompts };
-    logSection(log, 'CICD authentication');
-    const cicd = await configureCicd(section);
-    logSection(log, 'AI authentication');
-    const ai = await configureAi(section);
-    logSection(log, 'CRT authentication');
-    const crt = await configureCrt(section);
-    logSection(log, 'Cursor MCP');
-    const cursorMcp = await configureCursorMcp(section, context.projectRoot);
-    logSection(log, 'Project files');
-    const assets = await runProjectSetup({
-        ...options,
-        log,
-        noPrompt,
-    }, {
-        ...resolved,
-        prompts,
-        runSetupSkills: resolved.runSetupSkills,
-    });
-    const nextSteps = buildNextSteps({
-        bin,
-        mcpConfigured: cursorMcp.local.configured || cursorMcp.global.configured,
-    });
-    log('');
-    log('Next steps:');
-    for (const step of nextSteps) {
-        log(`  • ${step}`);
-    }
-    return {
-        ...assets,
-        auth: { ai, cicd, crt },
-        cursorMcp,
-        nextSteps,
-    };
-}
-//# sourceMappingURL=setup-wizard.js.map
+import {modules} from './runtime.js';
+const resetSetupWizardDepsForTests = modules["setup-wizard.js"]["resetSetupWizardDepsForTests"]
+const runSetupWizard = modules["setup-wizard.js"]["runSetupWizard"]
+const setSetupWizardDepsForTests = modules["setup-wizard.js"]["setSetupWizardDepsForTests"]
+export {resetSetupWizardDepsForTests, runSetupWizard, setSetupWizardDepsForTests};