crewly 1.20.133 → 1.20.134

package/dist/cli/cli/src/commands/deploy-bundle.d.ts

@@ -0,0 +1,160 @@
+/**
+ * CLI: deploy a solution bundle (specs/solution-bundles.md).
+ *
+ *   crewly deploy-bundle <template-id> --answers answers.json [--runtime crewly-agent]
+ *                        [--templates-dir <dir>] [--dry-run] [--allow-draft] [--json]
+ *
+ * Scripted deploys (hosted servers run it from cloud-init) and
+ * `crewly onboard --template <bundle>` both come here. When this user's
+ * backend is running, the deploy goes through `POST /api/bundles/apply` and
+ * the job is followed until it finishes, so Slack, connector checks and the
+ * first-week hand-offs happen right away. Otherwise the same engine runs
+ * in-process: the team, norms, SOPs, skills and schedules are written, and
+ * the steps that need a running Crewly are left pending — the backend
+ * finishes them when it starts.
+ *
+ * @module cli/commands/deploy-bundle
+ */
+import { BundleCatalog } from '../../../backend/src/services/bundle/bundle-catalog.js';
+import type { BundleDeployment, BundleQuestion } from '../../../backend/src/types/solution-bundle.types.js';
+import { type HttpJson } from '../utils/harness-engine.js';
+/** Output function. */
+type Log = (line: string) => void;
+/** Command options (Commander). */
+export interface DeployBundleOptions {
+    /** JSON file with `{ "<question id>": "<answer>" }` */
+    answers?: string;
+    /** Runtime for every member (default: recommended if this machine can run it, else the orchestrator's) */
+    runtime?: string;
+    /** Extra template directories (repeatable), e.g. crewly-pro/config/templates */
+    templatesDir?: string[];
+    /** Validate and print the plan without deploying */
+    dryRun?: boolean;
+    /** Deploy a bundle marked `draft` */
+    allowDraft?: boolean;
+    /** Print the final deployment as JSON */
+    json?: boolean;
+}
+/** A deploy target: the running backend or the in-process engine. */
+export interface BundleDeployTarget {
+    readonly where: 'backend' | 'in-process';
+    start(request: {
+        templateId: string;
+        answers?: unknown;
+        runtime?: string;
+        allowDraft?: boolean;
+    }): Promise<BundleDeployment>;
+    getJob(jobId: string): Promise<BundleDeployment>;
+    /** In-process only: wait for the run started by `start` */
+    wait?(request: {
+        templateId: string;
+        answers?: unknown;
+        runtime?: string;
+        allowDraft?: boolean;
+    }): Promise<BundleDeployment>;
+}
+/** Injectable pieces (tests). */
+export interface DeployBundleDeps {
+    log?: Log;
+    readFile?: (file: string) => string;
+    /** Catalog used to validate before deploying */
+    catalog?: Pick<BundleCatalog, 'get'>;
+    /** Whether this user's backend is running */
+    isRunning?: () => Promise<boolean>;
+    /** Target when the backend is running */
+    remote?: () => BundleDeployTarget;
+    /** Target when it is not */
+    local?: (templateDirs: string[]) => BundleDeployTarget | Promise<BundleDeployTarget>;
+    sleep?: (ms: number) => Promise<void>;
+    /** Clock for the poll timeout */
+    now?: () => number;
+}
+/**
+ * The Crewly package root the CLI runs from.
+ *
+ * @returns Absolute path (parent of `config/templates`)
+ */
+export declare function cliPackageRoot(): string;
+/**
+ * Read a JSON answers file.
+ *
+ * @param file - Path
+ * @param readFile - File reader
+ * @returns Answers object
+ * @throws Error with an owner-readable message when missing or not a JSON object
+ */
+export declare function loadAnswersFile(file: string, readFile?: (f: string) => string): Record<string, unknown>;
+/**
+ * An answers-file skeleton for a bundle (printed when answers are missing).
+ *
+ * @param questions - Bundle questions
+ * @returns Pretty JSON with every question id
+ */
+export declare function answersSkeleton(questions: BundleQuestion[]): string;
+/**
+ * The running backend as a deploy target.
+ *
+ * @param baseUrl - Loopback URL
+ * @param http - HTTP helper
+ * @returns Target
+ */
+export declare function createRemoteTarget(baseUrl?: string, http?: HttpJson): BundleDeployTarget;
+/**
+ * The in-process engine as a deploy target (no Slack, connector checks or
+ * orchestrator: those steps stay pending until the backend starts).
+ *
+ * Loaded lazily: the engine's collaborators pull in the marketplace
+ * installer and the harness store, which `crewly onboard` / `crewly doctor`
+ * should not load unless a bundle is actually deployed.
+ *
+ * @param templateDirs - Extra template directories
+ * @returns Target
+ */
+export declare function createLocalTarget(templateDirs: string[]): Promise<BundleDeployTarget>;
+/**
+ * Human-readable lines for a deployment.
+ *
+ * @param deployment - Deployment
+ * @returns Lines (no trailing newline)
+ */
+export declare function formatDeployment(deployment: BundleDeployment): string[];
+/**
+ * Whether a finished deployment should fail the command.
+ *
+ * @param deployment - Deployment
+ * @returns True when the team failed or any step failed
+ */
+export declare function deploymentFailed(deployment: BundleDeployment): boolean;
+/**
+ * Deploy a bundle (shared by `crewly deploy-bundle` and `crewly onboard`).
+ *
+ * @param templateId - Bundle template id
+ * @param options - Answers (object or file), runtime, flags
+ * @param deps - Injectable pieces
+ * @returns Process exit code (0 = deployed, possibly with pending steps; 1 = refused or failed)
+ */
+export declare function deployBundle(templateId: string, options: Omit<DeployBundleOptions, 'answers'> & {
+    answers?: Record<string, unknown>;
+}, deps?: DeployBundleDeps): Promise<number>;
+/**
+ * `crewly deploy-bundle <id>` action.
+ *
+ * @param templateId - Bundle template id
+ * @param options - Commander options
+ * @param deps - Injectable pieces
+ */
+export declare function deployBundleCommand(templateId: string, options?: DeployBundleOptions, deps?: DeployBundleDeps): Promise<void>;
+/**
+ * Ask a bundle's questions in the terminal. An answer from `preset` is
+ * kept; Enter takes the default; a select takes a number or a value; a
+ * multiselect takes comma-separated numbers or values.
+ *
+ * @param ask - Prompt function
+ * @param questions - Bundle questions
+ * @param preset - Answers already given (e.g. from --answers)
+ * @param log - Output
+ * @returns Answers
+ */
+export declare function askBundleQuestions(ask: (question: string) => Promise<string>, questions: BundleQuestion[], preset?: Record<string, unknown>, log?: Log): Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=deploy-bundle.d.ts.map

package/dist/cli/cli/src/commands/deploy-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-bundle.d.ts","sourceRoot":"","sources":["../../../../../cli/src/commands/deploy-bundle.ts"],"names":[],"mappings":"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"}

package/dist/cli/cli/src/commands/deploy-bundle.js

@@ -0,0 +1,386 @@
+/**
+ * CLI: deploy a solution bundle (specs/solution-bundles.md).
+ *
+ *   crewly deploy-bundle <template-id> --answers answers.json [--runtime crewly-agent]
+ *                        [--templates-dir <dir>] [--dry-run] [--allow-draft] [--json]
+ *
+ * Scripted deploys (hosted servers run it from cloud-init) and
+ * `crewly onboard --template <bundle>` both come here. When this user's
+ * backend is running, the deploy goes through `POST /api/bundles/apply` and
+ * the job is followed until it finishes, so Slack, connector checks and the
+ * first-week hand-offs happen right away. Otherwise the same engine runs
+ * in-process: the team, norms, SOPs, skills and schedules are written, and
+ * the steps that need a running Crewly are left pending — the backend
+ * finishes them when it starts.
+ *
+ * @module cli/commands/deploy-bundle
+ */
+import { readFileSync } from 'fs';
+import * as path from 'path';
+import chalk from 'chalk';
+import { BUNDLE_CONSTANTS } from '../../../backend/src/constants.js';
+import { getCrewlyHomePath } from '../../../backend/src/services/core/crewly-home.utils.js';
+import { BundleApplyService, BundleError } from '../../../backend/src/services/bundle/bundle-apply.service.js';
+import { BundleCatalog, bundleTemplateDirs, toBundleDetail } from '../../../backend/src/services/bundle/bundle-catalog.js';
+import { BundleAnswersError, resolveAnswers } from '../../../backend/src/services/bundle/bundle-placeholders.js';
+import { CLI_CONSTANTS } from '../constants.js';
+import { defaultHttpJson, isBackendRunning, localBackendUrl } from '../utils/harness-engine.js';
+import { getTemplatesDir } from '../utils/templates.js';
+/**
+ * The Crewly package root the CLI runs from.
+ *
+ * @returns Absolute path (parent of `config/templates`)
+ */
+export function cliPackageRoot() {
+    return path.dirname(path.dirname(getTemplatesDir()));
+}
+/**
+ * Read a JSON answers file.
+ *
+ * @param file - Path
+ * @param readFile - File reader
+ * @returns Answers object
+ * @throws Error with an owner-readable message when missing or not a JSON object
+ */
+export function loadAnswersFile(file, readFile = (f) => readFileSync(f, 'utf-8')) {
+    let text;
+    try {
+        text = readFile(file);
+    }
+    catch {
+        throw new Error(`Cannot read the answers file: ${file}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`The answers file is not valid JSON (${file}): ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`The answers file must be a JSON object like {"business_name": "…"} (${file})`);
+    }
+    return parsed;
+}
+/**
+ * An answers-file skeleton for a bundle (printed when answers are missing).
+ *
+ * @param questions - Bundle questions
+ * @returns Pretty JSON with every question id
+ */
+export function answersSkeleton(questions) {
+    const skeleton = {};
+    for (const q of questions) {
+        skeleton[q.id] = q.type === 'multiselect' ? (Array.isArray(q.default) ? q.default : []) : typeof q.default === 'string' ? q.default : '';
+    }
+    return JSON.stringify(skeleton, null, 2);
+}
+/**
+ * The running backend as a deploy target.
+ *
+ * @param baseUrl - Loopback URL
+ * @param http - HTTP helper
+ * @returns Target
+ */
+export function createRemoteTarget(baseUrl = localBackendUrl(), http = defaultHttpJson) {
+    /** Unwrap `{ success, data }`, turning errors into BundleError-like errors. */
+    const unwrap = (status, body) => {
+        const b = body;
+        if (status < 300 && b?.success && b.data !== undefined)
+            return b.data;
+        const code = (b?.code ?? 'unknown_bundle');
+        const details = Array.isArray(b?.missing) || Array.isArray(b?.invalid)
+            ? { missing: (b?.missing ?? []), invalid: (b?.invalid ?? []) }
+            : undefined;
+        throw new BundleError(code, b?.error ?? `HTTP ${status}`, details);
+    };
+    return {
+        where: 'backend',
+        async start(request) {
+            const { status, body } = await http('POST', `${baseUrl}${CLI_CONSTANTS.BUNDLE.APPLY_ENDPOINT}`, request);
+            return unwrap(status, body).deployment;
+        },
+        async getJob(jobId) {
+            const { status, body } = await http('GET', `${baseUrl}${CLI_CONSTANTS.BUNDLE.APPLY_ENDPOINT}/${encodeURIComponent(jobId)}`);
+            return unwrap(status, body);
+        },
+    };
+}
+/**
+ * The in-process engine as a deploy target (no Slack, connector checks or
+ * orchestrator: those steps stay pending until the backend starts).
+ *
+ * Loaded lazily: the engine's collaborators pull in the marketplace
+ * installer and the harness store, which `crewly onboard` / `crewly doctor`
+ * should not load unless a bundle is actually deployed.
+ *
+ * @param templateDirs - Extra template directories
+ * @returns Target
+ */
+export async function createLocalTarget(templateDirs) {
+    const [{ createBaseBundleDeps }, { OrcHarnessStore }] = await Promise.all([
+        import('../../../backend/src/services/bundle/bundle-deps.js'),
+        import('../../../backend/src/services/harness/orc-harness.store.js'),
+    ]);
+    const store = new OrcHarnessStore();
+    const service = new BundleApplyService(createBaseBundleDeps({
+        crewlyHome: getCrewlyHomePath(),
+        packageRoot: cliPackageRoot(),
+        extraTemplateDirs: templateDirs,
+        getOrcHarness: () => store.get(),
+    }));
+    return {
+        where: 'in-process',
+        start: (request) => service.start(request),
+        getJob: (jobId) => service.getJob(jobId),
+        wait: (request) => service.applyAndWait(request),
+    };
+}
+/** Status marks for the step list. */
+const STEP_MARKS = {
+    done: chalk.green('✓'),
+    skipped: chalk.gray('–'),
+    pending: chalk.yellow('…'),
+    failed: chalk.red('✗'),
+    running: chalk.cyan('→'),
+    queued: chalk.gray('·'),
+};
+/**
+ * Human-readable lines for a deployment.
+ *
+ * @param deployment - Deployment
+ * @returns Lines (no trailing newline)
+ */
+export function formatDeployment(deployment) {
+    const lines = [];
+    for (const step of deployment.steps) {
+        const detail = step.error ?? step.message ?? '';
+        lines.push(`  ${STEP_MARKS[step.status] ?? '·'} ${step.label}${detail ? chalk.gray(` — ${detail}`) : ''}`);
+        for (const item of step.items ?? []) {
+            if (item.status === 'done' && step.status === 'done')
+                continue;
+            lines.push(chalk.gray(`      ${STEP_MARKS[item.status] ?? '·'} ${item.label}${item.message ? `: ${item.message}` : ''}`));
+        }
+    }
+    const missing = deployment.connectors.filter((c) => c.status !== 'connected');
+    if (missing.length > 0) {
+        lines.push('');
+        lines.push(chalk.bold('  Connect these (on the Connections page, works from a phone):'));
+        for (const c of missing) {
+            lines.push(`    ${c.required ? '•' : '◦'} ${c.id}${c.products.length ? ` (${c.products.join(', ')})` : ''} — ${c.why} → ${c.connectPath}`);
+        }
+    }
+    return lines;
+}
+/**
+ * Whether a finished deployment should fail the command.
+ *
+ * @param deployment - Deployment
+ * @returns True when the team failed or any step failed
+ */
+export function deploymentFailed(deployment) {
+    return deployment.status === 'failed' || deployment.steps.some((s) => s.status === 'failed');
+}
+/**
+ * Explain a refused deploy.
+ *
+ * @param error - BundleError
+ * @param template - The bundle (for the answers skeleton), if known
+ * @param log - Output
+ */
+function reportBundleError(error, template, log) {
+    log(chalk.red(`  ✗ ${error.message}`));
+    if (error.code === 'invalid_answers' && template) {
+        log(chalk.gray('    Answers file template (fill in and pass with --answers):'));
+        for (const line of answersSkeleton(template.bundle.questions ?? []).split('\n'))
+            log(chalk.gray(`    ${line}`));
+    }
+}
+/**
+ * Deploy a bundle (shared by `crewly deploy-bundle` and `crewly onboard`).
+ *
+ * @param templateId - Bundle template id
+ * @param options - Answers (object or file), runtime, flags
+ * @param deps - Injectable pieces
+ * @returns Process exit code (0 = deployed, possibly with pending steps; 1 = refused or failed)
+ */
+export async function deployBundle(templateId, options, deps = {}) {
+    const log = deps.log ?? ((line) => console.log(line));
+    const templateDirs = (options.templatesDir ?? []).map((d) => path.resolve(d));
+    const catalog = deps.catalog ?? new BundleCatalog(() => bundleTemplateDirs(cliPackageRoot(), templateDirs));
+    const entry = catalog.get(templateId);
+    const template = entry?.template ?? null;
+    // Validate locally first for a clear message (the backend checks again).
+    // A dry run without answers only validates the template itself.
+    if (template && !(options.dryRun && !options.answers)) {
+        try {
+            resolveAnswers(template.bundle.questions ?? [], options.answers ?? {});
+        }
+        catch (error) {
+            if (error instanceof BundleAnswersError) {
+                reportBundleError(new BundleError('invalid_answers', error.message), template, log);
+                return CLI_CONSTANTS.EXIT_CODES.ERROR;
+            }
+            throw error;
+        }
+    }
+    if (options.dryRun) {
+        if (!template) {
+            log(chalk.red(`  ✗ No bundle "${templateId}" in ${bundleTemplateDirs(cliPackageRoot(), templateDirs).join(', ')}`));
+            return CLI_CONSTANTS.EXIT_CODES.ERROR;
+        }
+        const detail = toBundleDetail(template);
+        log(chalk.bold(`  ${detail.label} (${detail.id}) — ${detail.status}`));
+        log(`  ${detail.tagline}`);
+        for (const team of detail.teams)
+            log(`  Team ${team.name}: ${team.members.map((m) => `${m.name} (${m.title})`).join(', ')}`);
+        log(`  Runtime: ${detail.recommendedRuntime} · Server: ${detail.serverTier}`);
+        log(`  Skills: ${detail.skills.join(', ') || '—'}`);
+        log(`  Connectors: ${detail.connectors.map((c) => c.id).join(', ') || '—'}`);
+        log(`  Schedules: ${detail.schedules.map((s) => `${s.title} (${s.cron})`).join(', ') || '—'}`);
+        log(`  First week: ${detail.firstWeek.map((t) => `day ${t.day + 1} ${t.title}`).join(', ') || '—'}`);
+        log(chalk.green('  ✓ Valid. Nothing was deployed (--dry-run).'));
+        return CLI_CONSTANTS.EXIT_CODES.SUCCESS;
+    }
+    const running = await (deps.isRunning ?? (() => isBackendRunning()))();
+    const target = running ? (deps.remote ?? (() => createRemoteTarget()))() : await (deps.local ?? createLocalTarget)(templateDirs);
+    if (running && templateDirs.length > 0) {
+        log(chalk.yellow('  ⚠ Crewly is running: --templates-dir is not seen by it. Start it with CREWLY_TEMPLATE_DIRS set instead.'));
+    }
+    const request = {
+        templateId,
+        ...(options.answers ? { answers: options.answers } : {}),
+        ...(options.runtime ? { runtime: options.runtime } : {}),
+        ...(options.allowDraft ? { allowDraft: true } : {}),
+    };
+    log(chalk.blue(`  Deploying ${template?.bundle.label ?? templateId} ${running ? 'through the running Crewly' : '(Crewly is not running; finishing the rest when it starts)'}…`));
+    let final;
+    try {
+        if (target.wait) {
+            final = await target.wait(request);
+        }
+        else {
+            const started = await target.start(request);
+            const sleep = deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+            const now = deps.now ?? (() => Date.now());
+            const deadline = now() + BUNDLE_CONSTANTS.CLI_JOB_TIMEOUT_MS;
+            final = started;
+            while (final.status === 'running' && now() < deadline) {
+                await sleep(BUNDLE_CONSTANTS.CLI_POLL_INTERVAL_MS);
+                final = await target.getJob(started.jobId);
+            }
+            if (final.status === 'running') {
+                log(chalk.yellow(`  ⚠ Still running after ${BUNDLE_CONSTANTS.CLI_JOB_TIMEOUT_MS / 60000} min; follow it at /api/bundles/apply/${started.jobId}`));
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof BundleError) {
+            reportBundleError(error, template, log);
+            return CLI_CONSTANTS.EXIT_CODES.ERROR;
+        }
+        log(chalk.red(`  ✗ ${error instanceof Error ? error.message : String(error)}`));
+        return CLI_CONSTANTS.EXIT_CODES.ERROR;
+    }
+    if (options.json) {
+        log(JSON.stringify(final, null, 2));
+    }
+    else {
+        for (const line of formatDeployment(final))
+            log(line);
+        log('');
+        if (final.status === 'done')
+            log(chalk.green('  ✓ Deployed.'));
+        else if (!deploymentFailed(final))
+            log(chalk.green('  ✓ Deployed; the steps marked … finish by themselves once they can.'));
+        else
+            log(chalk.red('  ✗ Some steps failed. Run the same command again to retry them; finished steps are kept.'));
+    }
+    return deploymentFailed(final) ? CLI_CONSTANTS.EXIT_CODES.ERROR : CLI_CONSTANTS.EXIT_CODES.SUCCESS;
+}
+/**
+ * `crewly deploy-bundle <id>` action.
+ *
+ * @param templateId - Bundle template id
+ * @param options - Commander options
+ * @param deps - Injectable pieces
+ */
+export async function deployBundleCommand(templateId, options = {}, deps = {}) {
+    const log = deps.log ?? ((line) => console.log(line));
+    let answers;
+    if (options.answers) {
+        try {
+            answers = loadAnswersFile(options.answers, deps.readFile);
+        }
+        catch (error) {
+            log(chalk.red(`  ✗ ${error instanceof Error ? error.message : String(error)}`));
+            process.exitCode = CLI_CONSTANTS.EXIT_CODES.ERROR;
+            return;
+        }
+    }
+    const code = await deployBundle(templateId, { ...options, answers }, deps);
+    if (code !== CLI_CONSTANTS.EXIT_CODES.SUCCESS)
+        process.exitCode = code;
+}
+/**
+ * Ask a bundle's questions in the terminal. An answer from `preset` is
+ * kept; Enter takes the default; a select takes a number or a value; a
+ * multiselect takes comma-separated numbers or values.
+ *
+ * @param ask - Prompt function
+ * @param questions - Bundle questions
+ * @param preset - Answers already given (e.g. from --answers)
+ * @param log - Output
+ * @returns Answers
+ */
+export async function askBundleQuestions(ask, questions, preset = {}, log = (line) => console.log(line)) {
+    const answers = { ...preset };
+    for (const q of questions) {
+        if (answers[q.id] !== undefined && answers[q.id] !== '')
+            continue;
+        const options = q.options ?? [];
+        for (;;) {
+            log(chalk.bold(`  ${q.label}${q.required ? '' : chalk.gray('（可选）')}`));
+            if (q.help)
+                log(chalk.gray(`    ${q.help}`));
+            options.forEach((o, i) => log(`    ${i + 1}. ${o.label ?? o.value}`));
+            const fallback = Array.isArray(q.default) ? q.default.join(', ') : q.default ?? '';
+            const raw = (await ask(`  > ${fallback ? chalk.gray(`[${fallback}] `) : ''}`)).trim();
+            if (raw === '') {
+                if (q.required) {
+                    log(chalk.yellow('    这一项必填。'));
+                    continue;
+                }
+                break; // default applies
+            }
+            const pick = (token) => {
+                const n = Number.parseInt(token, 10);
+                if (String(n) === token && n >= 1 && n <= options.length)
+                    return options[n - 1].value;
+                return options.some((o) => o.value === token) ? token : null;
+            };
+            if (q.type === 'select') {
+                const value = pick(raw);
+                if (!value) {
+                    log(chalk.yellow(`    请输入 1-${options.length}。`));
+                    continue;
+                }
+                answers[q.id] = value;
+            }
+            else if (q.type === 'multiselect') {
+                const values = raw.split(/[,，、\s]+/).filter(Boolean).map(pick);
+                if (values.some((v) => v === null)) {
+                    log(chalk.yellow(`    用逗号分开，比如 1,3。`));
+                    continue;
+                }
+                answers[q.id] = values;
+            }
+            else {
+                answers[q.id] = raw;
+            }
+            break;
+        }
+    }
+    return answers;
+}
+//# sourceMappingURL=deploy-bundle.js.map

package/dist/cli/cli/src/commands/deploy-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-bundle.js","sourceRoot":"","sources":["../../../../../cli/src/commands/deploy-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,8DAA8D,CAAC;AAC/G,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAC3H,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAEjH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAiB,MAAM,4BAA4B,CAAC;AAC/G,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA+CxD;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,WAAkC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC;IAC7G,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7H,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,uEAAuE,IAAI,GAAG,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAA2B;IACzD,MAAM,QAAQ,GAAsC,EAAE,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3I,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,eAAe,EAAE,EAAE,OAAiB,eAAe;IACtG,+EAA+E;IAC/E,MAAM,MAAM,GAAG,CAAI,MAAc,EAAE,IAAa,EAAK,EAAE;QACrD,MAAM,CAAC,GAAG,IAAmH,CAAC;QAC9H,IAAI,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC;QACtE,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,gBAAgB,CAAiD,CAAC;QAC3F,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC;YACpE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAY,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAY,EAAE;YACpF,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,QAAQ,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC,CAAC;IACF,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,KAAK,CAAC,KAAK,CAAC,OAAO;YACjB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;YACzG,OAAO,MAAM,CAAmC,MAAM,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC;QAC3E,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,GAAG,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,cAAc,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5H,OAAO,MAAM,CAAmB,MAAM,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,YAAsB;IAC5D,MAAM,CAAC,EAAE,oBAAoB,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxE,MAAM,CAAC,qDAAqD,CAAC;QAC7D,MAAM,CAAC,4DAA4D,CAAC;KACrE,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,kBAAkB,CACpC,oBAAoB,CAAC;QACnB,UAAU,EAAE,iBAAiB,EAAE;QAC/B,WAAW,EAAE,cAAc,EAAE;QAC7B,iBAAiB,EAAE,YAAY;QAC/B,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;KACjC,CAAC,CACH,CAAC;IACF,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAC1C,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACxC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,GAA2B;IACzC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;IACtB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACxB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;IAC1B,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;IACtB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA4B;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3G,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;gBAAE,SAAS;YAC/D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5H,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;IAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC,CAAC;QACzF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7I,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA4B;IAC3D,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,KAAkB,EAAE,QAA+B,EAAE,GAAQ;IACtF,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,QAAQ,EAAE,CAAC;QACjD,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC,CAAC;QAChF,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IAClH,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAkB,EAClB,OAAqF,EACrF,OAAyB,EAAE;IAE3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,aAAa,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,cAAc,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IAC5G,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAQ,IAAI,IAAI,CAAC;IAEzC,yEAAyE;IACzE,gEAAgE;IAChE,IAAI,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,iBAAiB,CAAC,IAAI,WAAW,CAAC,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;gBACpF,OAAO,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;YACxC,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,UAAU,QAAQ,kBAAkB,CAAC,cAAc,EAAE,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACpH,OAAO,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;QACxC,CAAC;QACD,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACxC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACvE,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK;YAAE,GAAG,CAAC,UAAU,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7H,GAAG,CAAC,cAAc,MAAM,CAAC,kBAAkB,cAAc,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QACpD,GAAG,CAAC,iBAAiB,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAC7E,GAAG,CAAC,gBAAgB,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAC/F,GAAG,CAAC,iBAAiB,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QACrG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC,CAAC;QACjE,OAAO,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,iBAAiB,CAAC,CAAC,YAAY,CAAC,CAAC;IACjI,IAAI,OAAO,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,2GAA2G,CAAC,CAAC,CAAC;IACjI,CAAC;IACD,MAAM,OAAO,GAAG;QACd,UAAU;QACV,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;IACF,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,EAAE,MAAM,CAAC,KAAK,IAAI,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,4DAA4D,GAAG,CAAC,CAAC,CAAC;IAEjL,IAAI,KAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1F,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3C,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAG,gBAAgB,CAAC,kBAAkB,CAAC;YAC7D,KAAK,GAAG,OAAO,CAAC;YAChB,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;gBACtD,MAAM,KAAK,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC;gBACnD,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,2BAA2B,gBAAgB,CAAC,kBAAkB,GAAG,KAAK,yCAAyC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACpJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YACxC,OAAO,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;QACxC,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAChF,OAAO,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;IACxC,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACtD,GAAG,CAAC,EAAE,CAAC,CAAC;QACR,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;aAC1D,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC,CAAC;;YACvH,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2FAA2F,CAAC,CAAC,CAAC;IACnH,CAAC;IACD,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC;AACrG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAkB,EAAE,UAA+B,EAAE,EAAE,OAAyB,EAAE;IAC1H,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,IAAI,OAA4C,CAAC;IACjD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAChF,OAAO,CAAC,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;YAClD,OAAO;QACT,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3E,IAAI,IAAI,KAAK,aAAa,CAAC,UAAU,CAAC,OAAO;QAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AACzE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAA0C,EAC1C,SAA2B,EAC3B,SAAkC,EAAE,EACpC,MAAW,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAEtC,MAAM,OAAO,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE;YAAE,SAAS;QAClE,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QAChC,SAAS,CAAC;YACR,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YACvE,IAAI,CAAC,CAAC,IAAI;gBAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7C,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;YACnF,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACtF,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;gBACf,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;oBACf,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;oBAChC,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,kBAAkB;YAC3B,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,KAAa,EAAiB,EAAE;gBAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACrC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM;oBAAE,OAAO,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;gBACtF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/D,CAAC,CAAC;YACF,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;gBACxB,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;oBAClD,SAAS;gBACX,CAAC;gBACD,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC/D,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;oBACnC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;oBACvC,SAAS;gBACX,CAAC;gBACD,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAkB,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;YACtB,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cli/cli/src/commands/onboard.d.ts

@@ -26,7 +26,10 @@
  *
  * Used directly via `crewly onboard`, by the curl install script, and by the
  * desktop app. Flags: `--yes`, `--template <id>`, `--harness <id>`, `--task <text>`,
- * `--web`, `--cli`.
+ * `--web`, `--cli`, and for a solution bundle (`--template <bundle id>`)
+ * `--answers <file>` / `--runtime <id>`: the bundle's questions are asked
+ * (or read from the file) and it is deployed in one step
+ * (specs/solution-bundles.md).
  *
  * @module cli/commands/onboard
  */
@@ -35,6 +38,7 @@ import { type TeamTemplate } from '../utils/templates.js';
 import type { HarnessService } from '../../../backend/src/services/harness/harness.service.js';
 import { type LoginDriver } from '../utils/harness-engine.js';
 import { type HarnessSetupResult, type SetupIO } from './harness-setup.js';
+import type { BundleTemplate } from '../../../backend/src/types/solution-bundle.types.js';
 import { type ConnectLinks, type ConnectState, type FirstTaskOutcome, type StarterChoice } from './onboard-checklist.js';
 /** Options passed from Commander.js for the onboard command */
 export interface OnboardOptions {
@@ -50,6 +54,10 @@ export interface OnboardOptions {
     cli?: boolean;
     /** First task for the new team (with --yes; otherwise it is asked) */
     task?: string;
+    /** Answers file (JSON) for a solution bundle's questions */
+    answers?: string;
+    /** Runtime for a solution bundle's members */
+    runtime?: string;
 }
 /** Where the rest of setup happens. */
 export type SetupMode = 'web' | 'cli';
@@ -71,6 +79,10 @@ export interface OnboardDeps {
     connectLinks?: () => ConnectLinks;
     /** Cloud / Slack state from the running backend (null when unknown) */
     readConnectState?: () => Promise<ConnectState | null>;
+    /** Find a solution bundle by template id (null when the id is not a bundle) */
+    findBundle?: (templateId: string) => BundleTemplate | null;
+    /** Deploy a solution bundle; returns the exit code */
+    deployBundle?: (templateId: string, answers: Record<string, unknown>, runtime: string | undefined) => Promise<number>;
 }
 /**
  * Prints the Crewly ASCII art banner to stdout.
@@ -345,6 +357,25 @@ export declare function runConnectStep(links: () => ConnectLinks, readState: ()
  * @param projectDir - The project directory path for next-steps output
  */
 export declare function printSummary(selectedTemplate?: TeamTemplate | null, projectDir?: string): void;
+/**
+ * A solution bundle by template id, from the OSS templates and
+ * CREWLY_TEMPLATE_DIRS (e.g. Crewly Pro's templates).
+ *
+ * @param templateId - Template id
+ * @returns The bundle, or null when the id is not a bundle
+ */
+export declare function findBundleTemplate(templateId: string): BundleTemplate | null;
+/**
+ * Step 4 for a solution bundle: its questions (unless `--answers` covers
+ * them, or `--yes` forbids asking), then the one-step deploy.
+ *
+ * @param bundle - Bundle template
+ * @param options - `--answers`, `--runtime`
+ * @param ask - Prompt function, or null in non-interactive mode
+ * @param deploy - Deploy function (exit code)
+ * @returns Whether the bundle deployed (possibly with pending steps)
+ */
+export declare function runBundleStep(bundle: BundleTemplate, options: Pick<OnboardOptions, 'answers' | 'runtime'>, ask: ((question: string) => Promise<string>) | null, deploy: (templateId: string, answers: Record<string, unknown>, runtime: string | undefined) => Promise<number>): Promise<boolean>;
 /**
  * Runs the onboarding wizard.
  *