carlin 1.40.2 → 1.42.0

package/README.md

@@ -1,340 +1,12 @@
 # carlin
 
-**carlin** is a CLI tool for deploying AWS cloud resources using CloudFormation templates. It streamlines infrastructure deployment with automatic Lambda code building, S3 upload handling, stack naming, and multi-environment support.
-
-## Installation
+CLI tool for deploying AWS cloud resources using CloudFormation templates.
 
 ```bash
 pnpm add -D carlin
 ```
 
-Or install globally:
-
-```bash
-pnpm add -g carlin
-```
-
-## Quick Start
-
-Deploy your CloudFormation template with a single command:
-
-```bash
-carlin deploy
-```
-
-carlin automatically:
-
-- Searches for your CloudFormation template (`cloudformation.ts`, `cloudformation.yml`, or `template.yml`)
-- Builds and uploads Lambda function code to S3
-- Creates or updates your CloudFormation stack
-- Displays stack outputs after deployment
-
-### First Deployment Example
-
-Create a simple CloudFormation template:
-
-```typescript
-// cloudformation.ts
-export const template = {
-  Resources: {
-    MyBucket: {
-      Type: 'AWS::S3::Bucket',
-      Properties: {
-        BucketName: 'my-app-bucket',
-      },
-    },
-  },
-  Outputs: {
-    BucketName: {
-      Value: { Ref: 'MyBucket' },
-    },
-  },
-};
-```
-
-Deploy it:
-
-```bash
-carlin deploy
-```
-
-That's it! carlin creates the stack and outputs the bucket name.
-
-## Core Concepts
-
-### Stack Naming
-
-carlin automatically generates CloudFormation stack names based on:
-
-1. Package name from `package.json`
-2. Environment (staging, production) or branch name
-3. Custom `--stack-name` option (overrides automatic naming)
-
-Example stack names:
-
-- `my-app-production` (package: `my-app`, environment: `production`)
-- `my-app-feature-auth` (package: `my-app`, branch: `feature/auth`)
-- `CustomStack` (using `--stack-name CustomStack`)
-
-### Environments
-
-Define environments using:
-
-- `--environment` flag: `carlin deploy --environment production`
-- `CARLIN_ENVIRONMENT` variable: `CARLIN_ENVIRONMENT=staging carlin deploy`
-- Config file: `carlin.yml` with `environment: production`
-
-Environments enable:
-
-- Automatic termination protection for production stacks
-- Environment-specific configurations
-- Multi-stage deployment workflows
-
-### Lambda Functions
-
-carlin automatically handles Lambda deployment:
-
-1. Detects Lambda functions in your CloudFormation template
-2. Builds code using esbuild
-3. Uploads to S3 with versioning
-4. Injects S3 parameters into your template
-
-Example Lambda function:
-
-```typescript
-// src/handler.ts
-export const handler = async (event) => {
-  return { statusCode: 200, body: 'Hello World' };
-};
-
-// cloudformation.ts
-export const template = {
-  Resources: {
-    MyFunction: {
-      Type: 'AWS::Lambda::Function',
-      Properties: {
-        Runtime: 'nodejs20.x',
-        Handler: 'handler.handler', // carlin finds and builds src/handler.ts
-        Code: {
-          S3Bucket: { Ref: 'LambdaS3Bucket' },
-          S3Key: { Ref: 'LambdaS3Key' },
-          S3ObjectVersion: { Ref: 'LambdaS3ObjectVersion' },
-        },
-      },
-    },
-  },
-};
-```
-
-### Base Stack
-
-The base stack provides shared infrastructure:
-
-- S3 bucket for Lambda code storage
-- CloudFront distribution for static apps
-- Lambda image builder for container deployments
-
-Deploy base stack once per environment:
-
-```bash
-carlin deploy base-stack --environment production
-```
-
-## Commands
-
-### deploy
-
-Deploy CloudFormation stacks and resources.
-
-```bash
-carlin deploy [options]
-```
-
-#### Main Options
-
-- `--template-path <path>` - CloudFormation template file path
-- `--stack-name <name>` - Custom stack name
-- `--parameters <json>` - CloudFormation parameters as JSON object
-- `--environment <env>` - Environment name (enables termination protection)
-- `--region <region>` - AWS region (default: `us-east-1`)
-- `--destroy` - Delete the stack instead of deploying
-
-#### Subcommands
-
-- `deploy static-app` - Deploy static websites to S3 + CloudFront
-- `deploy lambda-layer` - Deploy Lambda layers
-- `deploy base-stack` - Deploy base infrastructure stack
-- `deploy cicd` - Deploy CI/CD pipeline infrastructure
-- `deploy vercel` - Deploy to Vercel platform
-- `deploy describe` - Show stack outputs without deploying
-
-See [full command documentation](https://ttoss.dev/docs/carlin/commands/deploy) for all options and examples.
-
-### generate-env
-
-Generate `.env` files from CloudFormation stack outputs.
-
-```bash
-carlin generate-env --stack-name MyStack --output .env
-```
-
-Fetches stack outputs and creates environment variables file:
-
-```bash
-# Generated by carlin
-API_URL=https://api.example.com
-BUCKET_NAME=my-app-bucket-xyz123
-```
-
-### cicd-ecs-task-report
-
-Report ECS task status to GitHub/Slack during CI/CD deployments.
-
-```bash
-carlin cicd-ecs-task-report --cluster my-cluster --task-arn <arn>
-```
-
-## Configuration
-
-Configure carlin using CLI options, environment variables, or config files.
-
-### Config File
-
-Create `carlin.yml` in your project root:
-
-```yaml
-environment: staging
-region: us-east-1
-stackName: my-custom-stack
-parameters:
-  DomainName: example.com
-  CertificateArn: arn:aws:acm:...
-```
-
-### Environment Variables
-
-Prefix any option with `CARLIN_`:
-
-```bash
-CARLIN_ENVIRONMENT=production carlin deploy
-CARLIN_REGION=eu-west-1 carlin deploy
-CARLIN_STACK_NAME=CustomStack carlin deploy
-```
-
-### Priority
-
-Configuration priority (highest to lowest):
-
-1. CLI options (`--environment production`)
-2. Environment variables (`CARLIN_ENVIRONMENT=production`)
-3. Config file (`carlin.yml`)
-4. Defaults
-
-## Advanced Usage
-
-### Multi-Environment Deployment
-
-Deploy to multiple environments with different configurations:
-
-```bash
-# Deploy to staging
-carlin deploy --environment staging --parameters '{"InstanceType":"t3.micro"}'
-
-# Deploy to production
-carlin deploy --environment production --parameters '{"InstanceType":"t3.large"}'
-```
-
-### Custom Template Paths
-
-Search for templates in custom locations:
-
-```bash
-carlin deploy --template-path infrastructure/cloudformation.ts
-```
-
-### Docker-Based Lambda Functions
-
-Build Lambda functions from Dockerfiles:
-
-```bash
-carlin deploy --lambda-dockerfile Dockerfile
-```
-
-carlin automatically:
-
-- Builds the Docker image
-- Pushes to ECR
-- Updates Lambda function with new image URI
-
-### Termination Protection
-
-Production stacks are protected from accidental deletion:
-
-```bash
-# This fails if environment is defined
-carlin deploy --destroy --environment production
-
-# Force deletion by removing environment
-carlin deploy --destroy --stack-name my-stack-production
-```
-
-### Branch-Based Deployments
-
-Deploy feature branches for testing:
-
-```bash
-# On feature/auth branch
-carlin deploy
-# Creates stack: my-app-feature-auth
-
-# On main branch
-carlin deploy --environment production
-# Creates stack: my-app-production
-```
-
-## Troubleshooting
-
-### Stack Already Exists
-
-If deployment fails with "Stack already exists", check:
-
-- Stack name conflicts (use `--stack-name` to customize)
-- Existing stacks in AWS Console (CloudFormation → Stacks)
-- Branch name conflicts (different branches may create same stack name)
-
-### Lambda Build Failures
-
-If Lambda code building fails:
-
-- Verify `Handler` path points to existing file (`src/handler.ts`)
-- Check `--lambda-entry-points-base-dir` matches your source directory
-- Review build logs for missing dependencies
-
-### Template Too Large
-
-CloudFormation templates over 51,200 bytes must be uploaded to S3:
-
-- carlin automatically uploads large templates to base stack bucket
-- Ensure base stack exists: `carlin deploy base-stack`
-- Or reduce template size by removing comments/whitespace
-
-### Permission Errors
-
-Ensure AWS credentials have necessary permissions:
-
-- `cloudformation:*` for stack operations
-- `s3:*` for Lambda code uploads
-- `iam:*` for creating roles
-- `lambda:*` for function deployments
-
-## Examples
-
-- [Terezinha Farm API](https://github.com/ttoss/ttoss/tree/main/terezinha-farm/api)
-- [POC - AWS Serverless REST API](https://github.com/ttoss/poc-aws-serverless-rest-api)
-
-## Documentation
-
-Full documentation: https://ttoss.dev/docs/carlin/
+**[Documentation →](https://ttoss.dev/docs/carlin/)**
 
 ## License
 

package/dist/index.js

@@ -997,24 +997,24 @@ var getStackName = /* @__PURE__ */ __name(async () => {
   }).join("-");
   return limitStackName(name);
 }, "getStackName");
-var deployErrorLogs = /* @__PURE__ */ __name(({ error, logPrefix: logPrefix23 }) => {
-  log5.error(logPrefix23, `An error occurred. Cannot deploy ${logPrefix23}.`);
-  log5.error(logPrefix23, "Error message: %j", error?.message);
+var deployErrorLogs = /* @__PURE__ */ __name(({ error, logPrefix: logPrefix24 }) => {
+  log5.error(logPrefix24, `An error occurred. Cannot deploy ${logPrefix24}.`);
+  log5.error(logPrefix24, "Error message: %j", error?.message);
 }, "deployErrorLogs");
-var handleDeployError = /* @__PURE__ */ __name(({ error, logPrefix: logPrefix23 }) => {
+var handleDeployError = /* @__PURE__ */ __name(({ error, logPrefix: logPrefix24 }) => {
   deployErrorLogs({
     error,
-    logPrefix: logPrefix23
+    logPrefix: logPrefix24
   });
   process.exit(1);
 }, "handleDeployError");
-var handleDeployInitialization = /* @__PURE__ */ __name(async ({ logPrefix: logPrefix23, stackName: preDefinedStackName }) => {
-  log5.info(logPrefix23, `Starting deploy ${logPrefix23}...`);
+var handleDeployInitialization = /* @__PURE__ */ __name(async ({ logPrefix: logPrefix24, stackName: preDefinedStackName }) => {
+  log5.info(logPrefix24, `Starting deploy ${logPrefix24}...`);
   if (preDefinedStackName) {
     setPreDefinedStackName(preDefinedStackName);
   }
   const stackName = await getStackName();
-  log5.info(logPrefix23, `stackName: ${stackName}`);
+  log5.info(logPrefix24, `stackName: ${stackName}`);
   return {
     stackName
   };
@@ -3726,6 +3726,154 @@ var readDockerfile = /* @__PURE__ */ __name((dockerfilePath) => {
     return "";
   }
 }, "readDockerfile");
+var logPrefix14 = "report";
+var getGitHubErrorMessage = /* @__PURE__ */ __name(async (response) => {
+  try {
+    const body = await response.json();
+    if (body.message) {
+      return `${response.status} ${response.statusText} - ${body.message}`;
+    }
+  } catch {
+  }
+  return `${response.status} ${response.statusText}`;
+}, "getGitHubErrorMessage");
+var GITHUB_PR_COMMENT_MARKER = "<!-- carlin-deploy-outputs -->";
+var readAllDeployFiles = /* @__PURE__ */ __name(async () => {
+  const files = await glob("**/.carlin/*.json", {
+    absolute: true,
+    ignore: [
+      "**/node_modules/**",
+      `**/.carlin/${LATEST_DEPLOY_OUTPUTS_FILENAME}`
+    ]
+  });
+  const results = [];
+  for (const file of files) {
+    try {
+      const raw = await fs3.promises.readFile(file, "utf-8");
+      const content = JSON.parse(raw);
+      if (content.stackName && content.outputs) {
+        results.push(content);
+      }
+    } catch {
+      log5.warn(logPrefix14, `Could not read deploy file: ${path.basename(file)}`);
+    }
+  }
+  return results.sort((a, b) => {
+    return a.packageName.localeCompare(b.packageName);
+  });
+}, "readAllDeployFiles");
+var buildMarkdownComment = /* @__PURE__ */ __name((deploys) => {
+  const header = `${GITHUB_PR_COMMENT_MARKER}
+
+## Deploy Outputs
+`;
+  if (deploys.length === 0) {
+    return `${header}
+No deploy outputs found.`;
+  }
+  const rows = deploys.flatMap(({ packageName, stackName, outputs }) => {
+    return Object.values(outputs).map(({ OutputKey, OutputValue }) => {
+      return `| \`${packageName}\` | \`${stackName}\` | \`${OutputKey}\` | ${OutputValue} |`;
+    });
+  });
+  const table = [
+    "| Package | Stack | Output Key | Output Value |",
+    "|---------|-------|------------|--------------|",
+    ...rows
+  ].join("\n");
+  return `${header}
+${table}`;
+}, "buildMarkdownComment");
+var getPrNumber = /* @__PURE__ */ __name(async ({ branch, repo, token }) => {
+  const [owner] = repo.split("/");
+  const response = await fetch(`https://api.github.com/repos/${repo}/pulls?head=${owner}:${branch}&state=open&per_page=1`, {
+    headers: {
+      Accept: "application/vnd.github+json",
+      Authorization: `Bearer ${token}`,
+      "X-GitHub-Api-Version": "2022-11-28"
+    }
+  });
+  if (!response.ok) {
+    throw new Error(`GitHub API error fetching PR: ${await getGitHubErrorMessage(response)}`);
+  }
+  const prs = await response.json();
+  if (prs.length === 0) {
+    throw new Error(`No open PR found for branch: ${branch}`);
+  }
+  return prs[0].number;
+}, "getPrNumber");
+var findExistingComment = /* @__PURE__ */ __name(async ({ prNumber, repo, token }) => {
+  const response = await fetch(`https://api.github.com/repos/${repo}/issues/${prNumber}/comments?per_page=100`, {
+    headers: {
+      Accept: "application/vnd.github+json",
+      Authorization: `Bearer ${token}`,
+      "X-GitHub-Api-Version": "2022-11-28"
+    }
+  });
+  if (!response.ok) {
+    throw new Error(`GitHub API error fetching comments: ${await getGitHubErrorMessage(response)}`);
+  }
+  const comments = await response.json();
+  return comments.find(({ body }) => {
+    return body.includes(GITHUB_PR_COMMENT_MARKER);
+  });
+}, "findExistingComment");
+var createOrUpdateComment = /* @__PURE__ */ __name(async ({ body, existingCommentId, prNumber, repo, token }) => {
+  const url = existingCommentId ? `https://api.github.com/repos/${repo}/issues/comments/${existingCommentId}` : `https://api.github.com/repos/${repo}/issues/${prNumber}/comments`;
+  const method = existingCommentId ? "PATCH" : "POST";
+  const response = await fetch(url, {
+    body: JSON.stringify({
+      body
+    }),
+    headers: {
+      Accept: "application/vnd.github+json",
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json",
+      "X-GitHub-Api-Version": "2022-11-28"
+    },
+    method
+  });
+  if (!response.ok) {
+    throw new Error(`GitHub API error ${method} comment: ${await getGitHubErrorMessage(response)}`);
+  }
+}, "createOrUpdateComment");
+var reportToGitHubPR = /* @__PURE__ */ __name(async () => {
+  const token = process.env.GH_TOKEN;
+  const repo = process.env.GITHUB_REPOSITORY;
+  const branch = process.env.CARLIN_BRANCH;
+  if (!token) {
+    throw new Error("GH_TOKEN environment variable is required for --channel=github-pr");
+  }
+  if (!repo) {
+    throw new Error("GITHUB_REPOSITORY environment variable is required for --channel=github-pr");
+  }
+  if (!branch) {
+    throw new Error("CARLIN_BRANCH environment variable is required for --channel=github-pr");
+  }
+  log5.info(logPrefix14, "Reading deploy outputs from workspace...");
+  const deploys = await readAllDeployFiles();
+  log5.info(logPrefix14, `Found ${deploys.length} deploy file(s).`);
+  const prNumber = await getPrNumber({
+    branch,
+    repo,
+    token
+  });
+  log5.info(logPrefix14, `Reporting to PR #${prNumber}...`);
+  const body = buildMarkdownComment(deploys);
+  const existingComment = await findExistingComment({
+    prNumber,
+    repo,
+    token
+  });
+  await createOrUpdateComment({
+    body,
+    existingCommentId: existingComment?.id,
+    prNumber,
+    repo,
+    token
+  });
+  log5.info(logPrefix14, existingComment ? "PR comment updated." : "PR comment created.");
+}, "reportToGitHubPR");
 
 // src/deploy/staticApp/findDefaultBuildFolder.ts
 var defaultBuildFolders = [
@@ -3780,11 +3928,11 @@ var getStaticAppBucket = /* @__PURE__ */ __name(async ({ stackName }) => {
   }
 }, "getStaticAppBucket");
 var CLOUDFRONT_DISTRIBUTION_ID = "CloudFrontDistributionId";
-var logPrefix14 = "static-app";
+var logPrefix15 = "static-app";
 var invalidateCloudFront = /* @__PURE__ */ __name(async ({ outputs }) => {
-  log5.info(logPrefix14, "Invalidating CloudFront...");
+  log5.info(logPrefix15, "Invalidating CloudFront...");
   if (!outputs) {
-    log5.info(logPrefix14, "Invalidation: outputs do not exist.");
+    log5.info(logPrefix15, "Invalidation: outputs do not exist.");
     return;
   }
   const cloudFrontDistributionIDOutput = outputs.find((output) => {
@@ -3807,13 +3955,13 @@ var invalidateCloudFront = /* @__PURE__ */ __name(async ({ outputs }) => {
     const cloudFront = new AWS.CloudFront();
     try {
       await cloudFront.createInvalidation(params).promise();
-      log5.info(logPrefix14, `CloudFront Distribution ID ${distributionId} invalidated with success.`);
+      log5.info(logPrefix15, `CloudFront Distribution ID ${distributionId} invalidated with success.`);
     } catch (err) {
-      log5.error(logPrefix14, `Error while trying to invalidate CloudFront distribution ${distributionId}.`);
-      log5.error(logPrefix14, err);
+      log5.error(logPrefix15, `Error while trying to invalidate CloudFront distribution ${distributionId}.`);
+      log5.error(logPrefix15, err);
     }
   } else {
-    log5.info(logPrefix14, `Cannot invalidate because distribution does not exist.`);
+    log5.info(logPrefix15, `Cannot invalidate because distribution does not exist.`);
   }
 }, "invalidateCloudFront");
 
@@ -4271,11 +4419,11 @@ var uploadBuiltAppToS3 = /* @__PURE__ */ __name(async ({ buildFolder: directory,
 }, "uploadBuiltAppToS3");
 
 // src/deploy/staticApp/deployStaticApp.ts
-var logPrefix15 = "static-app";
+var logPrefix16 = "static-app";
 var deployStaticApp = /* @__PURE__ */ __name(async ({ acm, aliases, appendIndexHtml, buildFolder, cloudfront, spa, hostedZoneName, region, skipUpload }) => {
   try {
     const { stackName } = await handleDeployInitialization({
-      logPrefix: logPrefix15
+      logPrefix: logPrefix16
     });
     const params = {
       StackName: stackName
@@ -4327,7 +4475,7 @@ var deployStaticApp = /* @__PURE__ */ __name(async ({ acm, aliases, appendIndexH
   } catch (error) {
     handleDeployError({
       error,
-      logPrefix: logPrefix15
+      logPrefix: logPrefix16
     });
   }
 }, "deployStaticApp");
@@ -4403,7 +4551,7 @@ var deployStaticAppCommand = {
     }
   }, "handler")
 };
-var logPrefix16 = "deploy vercel";
+var logPrefix17 = "deploy vercel";
 var makeCommand = /* @__PURE__ */ __name((cmds) => {
   return cmds.filter((cmd) => {
     return cmd !== void 0 && cmd !== null && cmd !== "";
@@ -4411,7 +4559,7 @@ var makeCommand = /* @__PURE__ */ __name((cmds) => {
 }, "makeCommand");
 var deployVercel = /* @__PURE__ */ __name(async ({ token }) => {
   try {
-    log5.info(logPrefix16, "Deploying on Vercel...");
+    log5.info(logPrefix17, "Deploying on Vercel...");
     const environment = getEnvironment();
     const finalToken = token || process.env.VERCEL_TOKEN;
     if (!finalToken) {
@@ -4446,11 +4594,11 @@ var deployVercel = /* @__PURE__ */ __name(async ({ token }) => {
   } catch (error) {
     handleDeployError({
       error,
-      logPrefix: logPrefix16
+      logPrefix: logPrefix17
     });
   }
 }, "deployVercel");
-var logPrefix17 = "deploy vercel";
+var logPrefix18 = "deploy vercel";
 var options4 = {
   token: {
     describe: "Vercel authorization token.",
@@ -4465,7 +4613,7 @@ var deployVercelCommand = {
   }, "builder"),
   handler: /* @__PURE__ */ __name(({ destroy: destroy2, ...rest }) => {
     if (destroy2) {
-      log5.info(logPrefix17, "Destroy Vercel deployment not implemented yet.");
+      log5.info(logPrefix18, "Destroy Vercel deployment not implemented yet.");
     } else {
       deployVercel(rest);
     }
@@ -4543,7 +4691,7 @@ var generateSSHCommandWithPwd = /* @__PURE__ */ __name(({ userName, host, passwo
 }, "generateSSHCommandWithPwd");
 
 // src/deploy/vm/deployVM.ts
-var logPrefix18 = "deploy-vm";
+var logPrefix19 = "deploy-vm";
 var deployVM = /* @__PURE__ */ __name(async ({ userName, host, scriptPath, keyPath, password, port, fixPermissions = false }) => {
   if (!userName || !host || !scriptPath) {
     throw new Error("Missing required parameters: userName, host, scriptPath");
@@ -4564,27 +4712,27 @@ var deployVM = /* @__PURE__ */ __name(async ({ userName, host, scriptPath, keyPa
           const permissionStr = permissions.toString(8);
           const fixCommand = `chmod 400 ${keyPath}`;
           if (fixPermissions) {
-            log5.info(logPrefix18, `Fixing SSH key permissions: ${keyPath} (${permissionStr} \u2192 400)`);
+            log5.info(logPrefix19, `Fixing SSH key permissions: ${keyPath} (${permissionStr} \u2192 400)`);
             chmodSync(keyPath, 256);
-            log5.info(logPrefix18, `Permissions set to 400 (read-only by owner)`);
+            log5.info(logPrefix19, `Permissions set to 400 (read-only by owner)`);
           } else {
-            log5.error(logPrefix18, `SSH key permissions too open: ${permissionStr} (octal)`);
-            log5.error(logPrefix18, `SSH requires permissions 400 or 600`);
-            log5.error(logPrefix18, `Fix manually: ${fixCommand}`);
-            log5.error(logPrefix18, `Or run with: --fix-permissions`);
+            log5.error(logPrefix19, `SSH key permissions too open: ${permissionStr} (octal)`);
+            log5.error(logPrefix19, `SSH requires permissions 400 or 600`);
+            log5.error(logPrefix19, `Fix manually: ${fixCommand}`);
+            log5.error(logPrefix19, `Or run with: --fix-permissions`);
             throw new Error(`Invalid SSH key permissions: ${permissionStr}. Expected 400 or 600.`);
           }
         } else {
-          log5.info(logPrefix18, `SSH key permissions OK: ${permissions.toString(8)}`);
+          log5.info(logPrefix19, `SSH key permissions OK: ${permissions.toString(8)}`);
         }
       } catch (error) {
         if (error instanceof Error) {
           if (error.message.includes("Invalid SSH key permissions")) {
             throw error;
           }
-          log5.warn(logPrefix18, `Warning: Could not check key permissions: ${error.message}`);
+          log5.warn(logPrefix19, `Warning: Could not check key permissions: ${error.message}`);
         } else {
-          log5.warn(logPrefix18, "Warning: Could not check key permissions: Unknown error");
+          log5.warn(logPrefix19, "Warning: Could not check key permissions: Unknown error");
         }
       }
     }
@@ -4619,15 +4767,15 @@ var deployVM = /* @__PURE__ */ __name(async ({ userName, host, scriptPath, keyPa
     });
     const validateStdin = /* @__PURE__ */ __name((stdin) => {
       if (!stdin) {
-        log5.error(logPrefix18, "SSH process stdin is null or undefined");
+        log5.error(logPrefix19, "SSH process stdin is null or undefined");
         return false;
       }
       if (stdin.destroyed) {
-        log5.error(logPrefix18, "SSH process stdin has been destroyed");
+        log5.error(logPrefix19, "SSH process stdin has been destroyed");
         return false;
       }
       if (!stdin.writable) {
-        log5.error(logPrefix18, "SSH process stdin is not writable");
+        log5.error(logPrefix19, "SSH process stdin is not writable");
         return false;
       }
       return true;
@@ -4638,7 +4786,7 @@ var deployVM = /* @__PURE__ */ __name(async ({ userName, host, scriptPath, keyPa
     }
     if (!existsSync(scriptPath)) {
       const message = `Deployment script not found at path: ${scriptPath}`;
-      log5.error(logPrefix18, message);
+      log5.error(logPrefix19, message);
       reject(new Error(message));
       return;
     }
@@ -4648,7 +4796,7 @@ var deployVM = /* @__PURE__ */ __name(async ({ userName, host, scriptPath, keyPa
     }
     deployScript.pipe(sshProcess.stdin);
     const sigintHandler = /* @__PURE__ */ __name(() => {
-      log5.info(logPrefix18, "Interrupting deployment...");
+      log5.info(logPrefix19, "Interrupting deployment...");
       sshProcess.kill("SIGINT");
       process.exit(130);
     }, "sigintHandler");
@@ -4672,7 +4820,7 @@ var deployVM = /* @__PURE__ */ __name(async ({ userName, host, scriptPath, keyPa
 }, "deployVM");
 
 // src/deploy/vm/command.ts
-var logPrefix19 = "deploy-vm";
+var logPrefix20 = "deploy-vm";
 var deployVMCommand = {
   command: "vm",
   describe: "Deploy to a VM via SSH by executing a deployment script",
@@ -4690,16 +4838,16 @@ var deployVMCommand = {
         port,
         fixPermissions
       });
-      log5.info(logPrefix19, "Deployment completed successfully!");
+      log5.info(logPrefix20, "Deployment completed successfully!");
     } catch (error) {
-      log5.error(logPrefix19, "Deployment failed: %s", error.message);
+      log5.error(logPrefix20, "Deployment failed: %s", error.message);
       process.exit(1);
     }
   }, "handler")
 };
 
 // src/deploy/command.ts
-var logPrefix20 = "deploy";
+var logPrefix21 = "deploy";
 var checkAwsAccountId = /* @__PURE__ */ __name(async (awsAccountId) => {
   try {
     const currentAwsAccountId = await getAwsAccountId();
@@ -4710,21 +4858,36 @@ var checkAwsAccountId = /* @__PURE__ */ __name(async (awsAccountId) => {
     if (error.code === "CredentialsError") {
       return;
     }
-    log5.error(logPrefix20, error.message);
+    log5.error(logPrefix21, error.message);
     process.exit();
   }
 }, "checkAwsAccountId");
-var describeDeployCommand = {
-  command: "describe",
-  describe: "Print the outputs of the deployment.",
-  handler: /* @__PURE__ */ __name(async ({ stackName }) => {
+var reportDeployCommand = {
+  command: "report",
+  describe: "Report the outputs of the deployment.",
+  builder: /* @__PURE__ */ __name((yargs3) => {
+    return yargs3.options({
+      channel: {
+        choices: [
+          "github-pr"
+        ],
+        describe: 'Report deploy outputs to the specified channel. Use "github-pr" to post or update a PR comment with all workspace deploy outputs.',
+        type: "string"
+      }
+    });
+  }, "builder"),
+  handler: /* @__PURE__ */ __name(async ({ stackName, channel }) => {
     try {
+      if (channel === "github-pr") {
+        await reportToGitHubPR();
+        return;
+      }
       const newStackName = stackName || await getStackName();
       await printStackOutputsAfterDeploy({
         stackName: newStackName
       });
     } catch (error) {
-      log5.info(logPrefix20, "Cannot describe stack. Message: %s", error.message);
+      log5.info(logPrefix21, "Cannot report stack. Message: %s", error.message);
     }
   }, "handler")
 };
@@ -4909,7 +5072,7 @@ var deployCommand = {
       }
     }).middleware(({ skipDeploy }) => {
       if (skipDeploy) {
-        log5.warn(logPrefix20, "Skip deploy flag is true, then the deploy command wasn't executed.");
+        log5.warn(logPrefix21, "Skip deploy flag is true, then the deploy command wasn't executed.");
         process.exit(0);
       }
     }).middleware(({ lambdaExternals, lambdaInput }) => {
@@ -4922,7 +5085,7 @@ var deployCommand = {
     });
     const commands = [
       deployLambdaLayerCommand,
-      describeDeployCommand,
+      reportDeployCommand,
       deployBaseStackCommand,
       deployStaticAppCommand,
       deployCicdCommand,
@@ -4950,10 +5113,10 @@ var deployCommand = {
     }
   }, "handler")
 };
-var logPrefix21 = "cicd-ecs-task-report";
+var logPrefix22 = "cicd-ecs-task-report";
 var sendEcsTaskReport = /* @__PURE__ */ __name(async ({ status }) => {
   if (!process.env.ECS_TASK_REPORT_HANDLER_NAME) {
-    log5.info(logPrefix21, "ECS_TASK_REPORT_HANDLER_NAME not defined.");
+    log5.info(logPrefix22, "ECS_TASK_REPORT_HANDLER_NAME not defined.");
     return;
   }
   const lambda = new AWS.Lambda();
@@ -4970,7 +5133,7 @@ var sendEcsTaskReport = /* @__PURE__ */ __name(async ({ status }) => {
     FunctionName: process.env.ECS_TASK_REPORT_HANDLER_NAME,
     InvokeArgs: JSON.stringify(payload)
   }).promise();
-  log5.info(logPrefix21, "Report sent.");
+  log5.info(logPrefix22, "Report sent.");
 }, "sendEcsTaskReport");
 var options7 = {
   status: {
@@ -4993,7 +5156,7 @@ var ecsTaskReportCommand = {
     return sendEcsTaskReport(args);
   }, "handler")
 };
-var logPrefix22 = "generate-env";
+var logPrefix23 = "generate-env";
 var readEnvFile = /* @__PURE__ */ __name(async ({ envFileName, envsPath }) => {
   try {
     const content = await fs3.promises.readFile(path.resolve(process.cwd(), envsPath, envFileName), "utf8");
@@ -5013,14 +5176,14 @@ var generateEnv = /* @__PURE__ */ __name(async ({ defaultEnvironment, path: envs
     envsPath
   });
   if (!envFile) {
-    log5.info(logPrefix22, "Env file %s doesn't exist. Skip generating env file.", envFileName);
+    log5.info(logPrefix23, "Env file %s doesn't exist. Skip generating env file.", envFileName);
     return;
   }
   await writeEnvFile({
     content: envFile,
     envFileName: ".env"
   });
-  log5.info(logPrefix22, "Generate env file %s from %s successfully.", ".env", envFileName);
+  log5.info(logPrefix23, "Generate env file %s from %s successfully.", ".env", envFileName);
 }, "generateEnv");
 
 // src/generateEnv/generateEnvCommand.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carlin",
-  "version": "1.40.2",
+  "version": "1.42.0",
   "description": "",
   "license": "MIT",
   "author": "Pedro Arantes <arantespp@gmail.com> (https://twitter.com/arantespp)",
@@ -47,9 +47,9 @@
     "uglify-js": "^3.19.3",
     "vercel": "^39.1.1",
     "yargs": "^17.7.2",
-    "@ttoss/cloudformation": "^0.11.10",
-    "@ttoss/config": "^1.35.12",
-    "@ttoss/read-config-file": "^2.0.20"
+    "@ttoss/cloudformation": "^0.12.0",
+    "@ttoss/config": "^1.36.0",
+    "@ttoss/read-config-file": "^2.1.0"
   },
   "devDependencies": {
     "@types/adm-zip": "^0.5.6",
@@ -60,7 +60,7 @@
     "@types/jest": "^30.0.0",
     "@types/js-yaml": "^4.0.9",
     "@types/mime-types": "^2.1.4",
-    "@types/node": "^22.19.0",
+    "@types/node": "^24.10.13",
     "@types/npmlog": "^7.0.0",
     "@types/semver": "^7.5.8",
     "@types/uglify-js": "^3.17.5",
@@ -69,7 +69,7 @@
     "jest": "^30.2.0",
     "tsup": "^8.5.1",
     "typescript": "~5.9.3",
-    "@ttoss/test-utils": "^4.0.3"
+    "@ttoss/test-utils": "^4.1.0"
   },
   "keywords": [],
   "publishConfig": {