@expressots/cli 3.0.0-beta.4 → 4.0.0-preview.2

package/README.md

@@ -1,118 +1,64 @@
-<a name="readme-top"></a>
-
-<!-- PROJECT SHIELDS -->
-
-[![Codecov][codecov-shield]][codecov-url]
-[![NPM][npm-shield]][npm-url]
-![Build][build-shield]
-[![Contributors][contributors-shield]][contributors-url]
-[![Forks][forks-shield]][forks-url]
-[![Stargazers][stars-shield]][stars-url]
-[![Issues][issues-shield]][issues-url]
-[![MIT License][license-shield]][license-url]
-[![LinkedIn][linkedin-shield]][linkedin-url]
-
-<!-- PROJECT LOGO -->
-<br />
 <div align="center">
-  <a href="https://github.com/othneildrew/Best-README-Template">
-    <img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" alt="Logo" width="120">
+  <a href="https://expresso-ts.com">
+    <img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" alt="ExpressoTS" width="120">
   </a>
 
-  <h3 align="center">ExpressoTS Framework</h3>
-
-  <p align="center">
-    Everything you need to know to build applications with ExpressoTS
-    <br />
-    <a href="https://doc.expresso-ts.com/"><strong>Explore the docs »</strong></a>
-    <br />
-    <br />
-    <a href="https://github.com/expressots/expressots/discussions">Let's discuss</a>
-    ·
-    <a href="https://github.com/expressots/expressots/issues">Report Bug</a>
-    ·
-    <a href="https://github.com/expressots/expressots/issues">Request Feature</a>
+  <h1>@expressots/cli</h1>
+
+  <p>Command-line tool for scaffolding, generating, and deploying ExpressoTS applications.</p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/@expressots/cli"><img src="https://img.shields.io/npm/v/@expressots/cli?style=flat&color=0d0d0d" alt="npm"></a>
+    <a href="https://github.com/expressots/expressots-cli/blob/main/LICENSE.md"><img src="https://img.shields.io/github/license/expressots/expressots-cli?style=flat&color=0d0d0d" alt="License"></a>
+    <a href="https://discord.com/invite/PyPJfGK"><img src="https://img.shields.io/badge/Discord-join-0d0d0d?logo=discord&logoColor=white" alt="Discord"></a>
+  </p>
+
+  <p>
+    <a href="https://doc.expresso-ts.com">Documentation</a> ·
+    <a href="https://doc.expresso-ts.com/docs/cli/overview">CLI Reference</a> ·
+    <a href="https://discord.com/invite/PyPJfGK">Community</a>
   </p>
 </div>
 
-<!-- TABLE OF CONTENTS -->
-<details>
-  <summary>Table of Contents</summary>
-  <ol>
-    <li><a href="#about-the-project">About The Project</a></li>
-    <li><a href="#getting-started">Getting Started</a></li>
-    <li><a href="#contributing">Contributing</a></li>
-    <li><a href="#support-the-project">Support the project</a></li>
-    <li><a href="#license">License</a></li>
-  </ol>
-</details>
+---
 
-<!-- ABOUT THE PROJECT -->
+## Install
 
-# About The Project
+```bash
+npm i -g @expressots/cli
+```
 
-ExpressoTS is a [Typescript](https://www.typescriptlang.org/) + [Node.js](https://nodejs.org/en/) lightweight framework for quick building scalable, easy to read and maintain, server-side applications 🐎
+## What This Package Does
 
-## Getting Started
+The ExpressoTS CLI creates new projects, generates controllers, use-cases, providers, and modules, manages CI/CD pipelines, Docker and Kubernetes configs, and handles deployment workflows — all from the terminal. It is the fastest way to go from zero to a running application.
 
--   Here is our [Site](https://expresso-ts.com/)
--   You can find our [Documentation here](https://doc.expresso-ts.com/)
--   Checkout our [First Steps documentation](https://doc.expresso-ts.com/docs/overview/first-steps)
--   Our [CLI Documentation](https://doc.expresso-ts.com/docs/cli/overview)
+## Quick Look
 
-## Contributing
+```bash
+# Create a new project
+expressots new my-app
 
-Welcome to the ExpressoTS community, a place bustling with innovative minds just like yours. We're absolutely thrilled to have you here!
-ExpressoTS is more than just a TypeScript framework; it's a collective effort by developers who are passionate about creating a more efficient, secure, and robust web ecosystem. We firmly believe that the best ideas come from a diversity of perspectives, backgrounds, and skills.
+# Generate a use-case
+expressots generate usecase user/create
 
-Why Contribute to Documentation?
+# Start in development
+expressots dev
+```
 
--   **Share Knowledge**: If you've figured out something cool, why keep it to yourself?
--   **Build Your Portfolio**: Contributing to an open-source project like ExpressoTS is a great way to showcase your skills.
--   **Join a Network**: Get to know a community of like-minded developers.
--   **Improve the Product**: Help us fill in the gaps, correct errors, or make complex topics easier to understand.
+## Documentation
 
-Ready to contribute?
+For the full command reference and usage guides visit **[doc.expresso-ts.com/docs/cli/overview](https://doc.expresso-ts.com/docs/cli/overview)**.
 
--   [Contributing Guidelines](https://github.com/expressots/expressots/blob/main/CONTRIBUTING.md)
--   [How to Contribute](https://github.com/expressots/expressots/blob/main/CONTRIBUTING_HOWTO.md)
--   [Coding Guidelines](https://github.com/rsaz/TypescriptCodingGuidelines)
+## Contributing
 
-## Support the project
+See the [Contributing Guide](https://github.com/expressots/expressots/blob/main/CONTRIBUTING.md) for how to get involved.
 
-ExpressoTS is an independent open source project with ongoing development made possible thanks to your support. If you'd like to help, please consider:
+## Support
 
--   Become a **[sponsor on GitHub](https://github.com/sponsors/expressots)**
--   Follow the **[organization](https://github.com/expressots)** on GitHub and Star ⭐ the project
--   Subscribe to the Twitch channel: **[Richard Zampieri](https://www.twitch.tv/richardzampieri)**
--   Join our **[Discord](https://discord.com/invite/PyPJfGK)**
--   Contribute submitting **[issues and pull requests](https://github.com/expressots/expressots/issues)**
--   Share the project with your friends and colleagues
+- [GitHub Sponsors](https://github.com/sponsors/expressots)
+- [Discord](https://discord.com/invite/PyPJfGK)
+- [Report an Issue](https://github.com/expressots/expressots-cli/issues)
 
 ## License
 
-Distributed under the MIT License. See [`LICENSE.txt`](https://github.com/expressots/expressots/blob/main/LICENSE) for more information.
-
-<p align="right">(<a href="#readme-top">back to top</a>)</p>
-
-<!-- MARKDOWN LINKS & IMAGES -->
-<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
-
-[codecov-url]: https://codecov.io/gh/expressots/expressots-cli
-[codecov-shield]: https://img.shields.io/codecov/c/gh/expressots/expressots-cli/main?style=for-the-badge&logo=codecov&labelColor=FB9AD1
-[npm-url]: https://www.npmjs.com/package/@expressots/expressots-cli
-[npm-shield]: https://img.shields.io/npm/v/%40expressots%2Fcli?style=for-the-badge&logo=npm&color=9B3922
-[build-shield]: https://img.shields.io/github/actions/workflow/status/expressots/expressots-cli/build.yml?branch=main&style=for-the-badge&logo=github
-[contributors-shield]: https://img.shields.io/github/contributors/expressots/expressots-cli?style=for-the-badge
-[contributors-url]: https://github.com/expressots/expressots-cli/graphs/contributors
-[forks-shield]: https://img.shields.io/github/forks/expressots/expressots-cli?style=for-the-badge
-[forks-url]: https://github.com/expressots/expressots-cli/forks
-[stars-shield]: https://img.shields.io/github/stars/expressots/expressots-cli?style=for-the-badge
-[stars-url]: https://github.com/expressots/expressots-cli/stargazers
-[issues-shield]: https://img.shields.io/github/issues/expressots/expressots-cli?style=for-the-badge
-[issues-url]: https://github.com/expressots/expressots-cli/issues
-[license-shield]: https://img.shields.io/github/license/expressots/expressots-cli?style=for-the-badge
-[license-url]: https://github.com/expressots/expressots-cli/blob/main/LICENSE
-[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
-[linkedin-url]: https://www.linkedin.com/company/expresso-ts/
-[product-screenshot]: images/screenshot.png
+MIT — see [LICENSE](./LICENSE.md).

package/bin/cicd/cli.d.ts

@@ -0,0 +1,6 @@
+import { CommandModule } from "yargs";
+type CommandModuleArgs = {};
+export type CIPlatform = "github" | "gitlab" | "circleci" | "jenkins" | "bitbucket" | "azure";
+export type CIStrategy = "basic" | "comprehensive" | "security-focused";
+declare const cicdCommand: () => CommandModule<CommandModuleArgs, any>;
+export { cicdCommand };

package/bin/cicd/cli.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cicdCommand = void 0;
+const form_1 = require("./form");
+const cicdCommand = () => {
+    return {
+        command: "cicd <action> [platform]",
+        describe: "Generate and manage CI/CD pipeline configurations.",
+        aliases: ["ci", "pipeline"],
+        builder: (yargs) => {
+            yargs.positional("action", {
+                choices: ["init", "generate", "list", "validate"],
+                describe: "Action to perform",
+                type: "string",
+                demandOption: true,
+            });
+            yargs.positional("platform", {
+                choices: [
+                    "github",
+                    "gitlab",
+                    "circleci",
+                    "jenkins",
+                    "bitbucket",
+                    "azure",
+                    "all",
+                ],
+                describe: "CI/CD platform to generate for",
+                type: "string",
+            });
+            yargs.option("strategy", {
+                choices: [
+                    "basic",
+                    "comprehensive",
+                    "security-focused",
+                ],
+                describe: "CI/CD pipeline strategy",
+                type: "string",
+                alias: "s",
+                default: "comprehensive",
+            });
+            yargs.option("include-security", {
+                describe: "Include security scanning (Trivy, Snyk)",
+                type: "boolean",
+                default: true,
+            });
+            yargs.option("include-e2e", {
+                describe: "Include end-to-end tests",
+                type: "boolean",
+                default: false,
+            });
+            yargs.option("include-coverage", {
+                describe: "Include code coverage reporting",
+                type: "boolean",
+                default: true,
+            });
+            yargs.option("docker-registry", {
+                describe: "Docker registry URL (e.g., ghcr.io, docker.io)",
+                type: "string",
+                alias: "r",
+            });
+            yargs.option("deploy-target", {
+                choices: [
+                    "kubernetes",
+                    "ecs",
+                    "cloudrun",
+                    "railway",
+                    "render",
+                    "fly",
+                    "none",
+                ],
+                describe: "Deployment target platform",
+                type: "string",
+                default: "none",
+            });
+            yargs.option("branch", {
+                describe: "Branch to trigger CI/CD on",
+                type: "string",
+                alias: "b",
+                default: "main",
+            });
+            yargs.option("node-version", {
+                describe: "Node.js version for CI",
+                type: "string",
+                default: "20",
+            });
+            yargs.option("output-dir", {
+                describe: "Output directory for generated files",
+                type: "string",
+                alias: "o",
+            });
+            return yargs;
+        },
+        handler: async (argv) => {
+            const { action, platform, strategy, includeSecurity, includeE2e, includeCoverage, dockerRegistry, deployTarget, branch, nodeVersion, outputDir, } = argv;
+            const options = {
+                platform: platform,
+                strategy: strategy,
+                includeSecurity,
+                includeE2E: includeE2e,
+                includeCoverage,
+                dockerRegistry,
+                deployTarget,
+                branch,
+                nodeVersion,
+                outputDir,
+            };
+            switch (action) {
+                case "init":
+                    await (0, form_1.initCICD)(options);
+                    break;
+                case "generate":
+                    await (0, form_1.generateCICD)(options);
+                    break;
+                case "list":
+                    await (0, form_1.listPlatforms)();
+                    break;
+                case "validate":
+                    await (0, form_1.validatePipelines)();
+                    break;
+                default:
+                    console.log(`Unknown action: ${action}`);
+            }
+        },
+    };
+};
+exports.cicdCommand = cicdCommand;

package/bin/cicd/form.d.ts

@@ -0,0 +1,29 @@
+import type { CIPlatform, CIStrategy } from "./cli";
+export interface CICDOptions {
+    platform?: CIPlatform | "all";
+    strategy: CIStrategy;
+    includeSecurity: boolean;
+    includeE2E: boolean;
+    includeCoverage: boolean;
+    dockerRegistry?: string;
+    deployTarget: string;
+    branch: string;
+    nodeVersion: string;
+    outputDir?: string;
+}
+/**
+ * Interactive CI/CD setup wizard
+ */
+export declare function initCICD(options: CICDOptions): Promise<void>;
+/**
+ * Generate CI/CD configuration for specific platform(s)
+ */
+export declare function generateCICD(options: CICDOptions): Promise<void>;
+/**
+ * List available CI/CD platforms
+ */
+export declare function listPlatforms(): Promise<void>;
+/**
+ * Validate existing CI/CD configurations
+ */
+export declare function validatePipelines(): Promise<void>;

package/bin/cicd/form.js

@@ -0,0 +1,345 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePipelines = exports.listPlatforms = exports.generateCICD = exports.initCICD = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const project_analyzer_1 = require("../containerize/analyzers/project-analyzer");
+const generators_1 = require("./generators");
+const PLATFORMS = [
+    {
+        id: "github",
+        name: "GitHub Actions",
+        description: "CI/CD for GitHub repositories",
+    },
+    {
+        id: "gitlab",
+        name: "GitLab CI",
+        description: "CI/CD for GitLab repositories",
+    },
+    {
+        id: "circleci",
+        name: "CircleCI",
+        description: "Cloud-based CI/CD platform",
+    },
+    {
+        id: "jenkins",
+        name: "Jenkins",
+        description: "Self-hosted automation server",
+    },
+    {
+        id: "bitbucket",
+        name: "Bitbucket Pipelines",
+        description: "CI/CD for Bitbucket Cloud",
+    },
+    {
+        id: "azure",
+        name: "Azure DevOps",
+        description: "Microsoft Azure CI/CD platform",
+    },
+];
+/**
+ * Interactive CI/CD setup wizard
+ */
+async function initCICD(options) {
+    console.log(chalk_1.default.cyan("\n🔧 ExpressoTS CI/CD Setup Wizard\n"));
+    // Analyze project first
+    const analysis = await (0, project_analyzer_1.analyzeProject)();
+    // Interactive prompts
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: "checkbox",
+            name: "platforms",
+            message: "Select CI/CD platforms to configure:",
+            choices: PLATFORMS.map((p) => ({
+                name: `${p.name} - ${p.description}`,
+                value: p.id,
+                checked: p.id === "github",
+            })),
+            validate: (input) => input.length > 0 || "Select at least one platform",
+        },
+        {
+            type: "list",
+            name: "strategy",
+            message: "Select CI/CD strategy:",
+            choices: [
+                { name: "Basic - Lint, test, build", value: "basic" },
+                {
+                    name: "Comprehensive - Full testing, security, coverage",
+                    value: "comprehensive",
+                },
+                {
+                    name: "Security-Focused - Maximum security scanning",
+                    value: "security-focused",
+                },
+            ],
+            default: "comprehensive",
+        },
+        {
+            type: "confirm",
+            name: "includeSecurity",
+            message: "Include security scanning (Trivy, Snyk)?",
+            default: true,
+        },
+        {
+            type: "confirm",
+            name: "includeE2E",
+            message: "Include end-to-end tests?",
+            default: false,
+        },
+        {
+            type: "confirm",
+            name: "includeCoverage",
+            message: "Include code coverage reporting?",
+            default: true,
+        },
+        {
+            type: "list",
+            name: "deployTarget",
+            message: "Select deployment target:",
+            choices: [
+                { name: "None (build only)", value: "none" },
+                { name: "Kubernetes", value: "kubernetes" },
+                { name: "AWS ECS", value: "ecs" },
+                { name: "Google Cloud Run", value: "cloudrun" },
+                { name: "Railway", value: "railway" },
+                { name: "Render", value: "render" },
+                { name: "Fly.io", value: "fly" },
+            ],
+            default: "none",
+        },
+        {
+            type: "input",
+            name: "dockerRegistry",
+            message: "Docker registry (leave empty for default):",
+            default: "",
+        },
+        {
+            type: "input",
+            name: "branch",
+            message: "Main branch name:",
+            default: "main",
+        },
+    ]);
+    // Generate for each selected platform
+    const selectedOptions = {
+        ...options,
+        strategy: answers.strategy,
+        includeSecurity: answers.includeSecurity,
+        includeE2E: answers.includeE2E,
+        includeCoverage: answers.includeCoverage,
+        deployTarget: answers.deployTarget,
+        dockerRegistry: answers.dockerRegistry || undefined,
+        branch: answers.branch,
+    };
+    console.log(chalk_1.default.yellow("\n📝 Generating CI/CD configurations...\n"));
+    for (const platform of answers.platforms) {
+        await generatePlatformConfig(platform, selectedOptions, analysis);
+    }
+    console.log(chalk_1.default.green("\n✅ CI/CD setup complete!\n"));
+    printNextSteps(answers.platforms, selectedOptions);
+}
+exports.initCICD = initCICD;
+/**
+ * Generate CI/CD configuration for specific platform(s)
+ */
+async function generateCICD(options) {
+    console.log(chalk_1.default.cyan("\n🔧 ExpressoTS CI/CD Generator\n"));
+    if (!options.platform) {
+        console.log(chalk_1.default.red("Error: Please specify a platform. Use 'expressots cicd list' to see available platforms."));
+        return;
+    }
+    const analysis = await (0, project_analyzer_1.analyzeProject)();
+    console.log(chalk_1.default.yellow("📝 Generating CI/CD configuration...\n"));
+    if (options.platform === "all") {
+        for (const platform of PLATFORMS) {
+            await generatePlatformConfig(platform.id, options, analysis);
+        }
+    }
+    else {
+        await generatePlatformConfig(options.platform, options, analysis);
+    }
+    console.log(chalk_1.default.green("\n✅ CI/CD configuration generated!\n"));
+    printNextSteps(options.platform === "all"
+        ? PLATFORMS.map((p) => p.id)
+        : [options.platform], options);
+}
+exports.generateCICD = generateCICD;
+/**
+ * List available CI/CD platforms
+ */
+async function listPlatforms() {
+    console.log(chalk_1.default.cyan("\n📋 Available CI/CD Platforms\n"));
+    console.log(chalk_1.default.bold("Platform".padEnd(20) + "Description".padEnd(45) + "Status"));
+    console.log("-".repeat(80));
+    for (const platform of PLATFORMS) {
+        const status = chalk_1.default.green("✓ Available");
+        console.log(chalk_1.default.white(platform.name.padEnd(20)) +
+            chalk_1.default.gray(platform.description.padEnd(45)) +
+            status);
+    }
+    console.log(chalk_1.default.gray("\nUsage: expressots cicd generate <platform>"));
+    console.log(chalk_1.default.gray("       expressots cicd generate all"));
+    console.log(chalk_1.default.gray("       expressots cicd init (interactive wizard)\n"));
+}
+exports.listPlatforms = listPlatforms;
+/**
+ * Validate existing CI/CD configurations
+ */
+async function validatePipelines() {
+    console.log(chalk_1.default.cyan("\n🔍 Validating CI/CD Configurations\n"));
+    const cwd = process.cwd();
+    const validations = [];
+    // Check for each platform's config file
+    const platformFiles = [
+        {
+            platform: "GitHub Actions",
+            paths: [
+                ".github/workflows/ci.yml",
+                ".github/workflows/docker-deploy.yml",
+            ],
+        },
+        { platform: "GitLab CI", paths: [".gitlab-ci.yml"] },
+        { platform: "CircleCI", paths: [".circleci/config.yml"] },
+        { platform: "Jenkins", paths: ["Jenkinsfile"] },
+        { platform: "Bitbucket", paths: ["bitbucket-pipelines.yml"] },
+        { platform: "Azure DevOps", paths: ["azure-pipelines.yml"] },
+    ];
+    for (const { platform, paths } of platformFiles) {
+        for (const filePath of paths) {
+            const fullPath = path_1.default.join(cwd, filePath);
+            const exists = fs_1.default.existsSync(fullPath);
+            if (exists) {
+                const issues = [];
+                let valid = true;
+                try {
+                    const content = fs_1.default.readFileSync(fullPath, "utf-8");
+                    // Basic validation checks
+                    if (content.length < 50) {
+                        issues.push("File seems too short");
+                        valid = false;
+                    }
+                    // Check for common issues
+                    if (filePath.endsWith(".yml") ||
+                        filePath.endsWith(".yaml")) {
+                        if (content.includes("\t")) {
+                            issues.push("Contains tabs (YAML should use spaces)");
+                        }
+                    }
+                    // Check for placeholder values
+                    if (content.includes("YOUR_") ||
+                        content.includes("<REPLACE>")) {
+                        issues.push("Contains placeholder values that need to be replaced");
+                    }
+                }
+                catch (err) {
+                    issues.push("Failed to read file");
+                    valid = false;
+                }
+                validations.push({
+                    platform,
+                    file: filePath,
+                    exists,
+                    valid,
+                    issues,
+                });
+            }
+        }
+    }
+    if (validations.length === 0) {
+        console.log(chalk_1.default.yellow("No CI/CD configuration files found."));
+        console.log(chalk_1.default.gray("\nRun 'expressots cicd init' to create CI/CD configurations.\n"));
+        return;
+    }
+    console.log(chalk_1.default.bold("File".padEnd(45) + "Status".padEnd(15) + "Issues"));
+    console.log("-".repeat(80));
+    for (const v of validations) {
+        const status = v.valid
+            ? chalk_1.default.green("✓ Valid")
+            : chalk_1.default.yellow("⚠ Warning");
+        const issues = v.issues.length > 0 ? chalk_1.default.gray(v.issues.join(", ")) : "";
+        console.log(chalk_1.default.white(v.file.padEnd(45)) + status.padEnd(24) + issues);
+    }
+    console.log();
+}
+exports.validatePipelines = validatePipelines;
+/**
+ * Generate configuration for a specific platform
+ */
+async function generatePlatformConfig(platform, options, analysis) {
+    const cwd = process.cwd();
+    const outputDir = options.outputDir || cwd;
+    const generatorOptions = {
+        projectName: analysis?.projectName || path_1.default.basename(cwd),
+        nodeVersion: options.nodeVersion || analysis?.nodeVersion || "20",
+        packageManager: analysis?.packageManager || "npm",
+        strategy: options.strategy,
+        includeSecurity: options.includeSecurity,
+        includeE2E: options.includeE2E,
+        includeCoverage: options.includeCoverage,
+        dockerRegistry: options.dockerRegistry,
+        deployTarget: options.deployTarget,
+        branch: options.branch,
+        port: analysis?.port || 3000,
+    };
+    switch (platform) {
+        case "github":
+            await (0, generators_1.generateGitHubActions)(outputDir, generatorOptions);
+            break;
+        case "gitlab":
+            await (0, generators_1.generateGitLabCI)(outputDir, generatorOptions);
+            break;
+        case "circleci":
+            await (0, generators_1.generateCircleCI)(outputDir, generatorOptions);
+            break;
+        case "jenkins":
+            await (0, generators_1.generateJenkinsfile)(outputDir, generatorOptions);
+            break;
+        case "bitbucket":
+            await (0, generators_1.generateBitbucketPipelines)(outputDir, generatorOptions);
+            break;
+        case "azure":
+            await (0, generators_1.generateAzureDevOps)(outputDir, generatorOptions);
+            break;
+    }
+}
+/**
+ * Print next steps after generation
+ */
+function printNextSteps(platforms, options) {
+    console.log(chalk_1.default.bold("📖 Next Steps:\n"));
+    console.log(chalk_1.default.white("1. Review generated configuration files"));
+    console.log(chalk_1.default.white("2. Configure required secrets in your CI/CD platform:\n"));
+    // Common secrets
+    const secrets = [
+        "DOCKER_USERNAME - Docker registry username",
+        "DOCKER_PASSWORD - Docker registry password/token",
+    ];
+    if (options.includeSecurity) {
+        secrets.push("SNYK_TOKEN - Snyk API token (optional)");
+    }
+    if (options.includeCoverage) {
+        secrets.push("CODECOV_TOKEN - Codecov upload token (optional)");
+    }
+    if (options.deployTarget === "kubernetes") {
+        secrets.push("KUBE_CONFIG - Kubernetes configuration");
+    }
+    else if (options.deployTarget === "railway") {
+        secrets.push("RAILWAY_TOKEN - Railway API token");
+    }
+    else if (options.deployTarget === "render") {
+        secrets.push("RENDER_API_KEY - Render API key");
+    }
+    else if (options.deployTarget === "fly") {
+        secrets.push("FLY_API_TOKEN - Fly.io API token");
+    }
+    for (const secret of secrets) {
+        console.log(chalk_1.default.gray(`   • ${secret}`));
+    }
+    console.log(chalk_1.default.white("\n3. Commit and push to trigger the pipeline"));
+    console.log(chalk_1.default.gray("\n💡 Tip: Run 'expressots cicd validate' to check your configurations\n"));
+}

package/bin/cicd/generators/azure-devops.d.ts

@@ -0,0 +1,2 @@
+import type { GeneratorOptions } from "./github-actions";
+export declare function generateAzureDevOps(outputDir: string, options: GeneratorOptions): Promise<void>;