awscfn 1.4.0 → 1.5.0

package/README.md

@@ -9,7 +9,7 @@
 [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)
 [![AutoRel](https://img.shields.io/badge/%F0%9F%9A%80%20AutoRel-2D4DDE)](https://github.com/mhweiner/autorel)
 
-Deploy CloudFormation stacks without the usual suffering.
+Deploy CloudFormation stacks with confidence.
 
 ## Why awscfn?
 
@@ -104,6 +104,28 @@ List all CloudFormation stacks in the current region (name, status, creation dat
 awscfn list-stacks
 ```
 
+### 🔎 inspect-stack
+
+Inspect a **deployed** stack in a **read-only pager view** (TUI-like), including:
+
+- full deployed template body
+- current parameters and outputs
+- stack metadata (raw JSON details)
+- event timeline (chronological)
+- failure events and likely root-cause errors
+
+```bash
+awscfn inspect-stack -n <STACK_NAME>
+```
+
+| Flag | Description |
+|------|-------------|
+| `--name`, `-n` | Stack name |
+| `--events`, `-e` | Max stack events to fetch (`0` = all available events). Default `500` |
+| `--pager` / `--no-pager` | Use a view-only pager (default true). Disable to print directly |
+
+This command performs read-only CloudFormation API calls (`DescribeStacks`, `GetTemplate`, `DescribeStackEvents`) and makes no stack changes.
+
 ### 🚀 create-stack
 
 ```bash

package/bin/awscfn

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
 
 const fs = require('fs');
+const os = require('os');
 const path = require('path');
+const { spawnSync } = require('node:child_process');
 const yargs = require('yargs');
 
 const { createStack } = require('../dist/createStack');
 const { deleteStack } = require('../dist/deleteStack');
 const { listStacks } = require('../dist/listStacks');
+const { inspectStack } = require('../dist/inspectStack');
 const { previewStack } = require('../dist/previewStack');
 const { redeployStack } = require('../dist/redeployStack');
 const { updateStack } = require('../dist/updateStack');
@@ -16,6 +19,9 @@ const pkg = JSON.parse(fs.readFileSync(path.resolve(__dirname, '../package.json'
 const isCI = process.env.CI === 'true' || process.env.GITHUB_ACTIONS === 'true';
 
 const FILE_FLAGS = ['--template', '--params', '-t', '-p'];
+const ASCII_LOGO = [
+  'awscfn',
+];
 
 function completeFile(current) {
   const dir = path.dirname(current) || '.';
@@ -49,6 +55,65 @@ function logError(msg) {
   console.log(`\x1b[31mError: ${msg}\x1b[0m`);
 }
 
+function maybeColorize(text, colorCode) {
+  if (!process.stdout.isTTY || process.env.NO_COLOR) {
+    return text;
+  }
+  return `${colorCode}${text}\x1b[0m`;
+}
+
+function runImageCommand(command, args) {
+  const result = spawnSync(command, args, { stdio: 'inherit' });
+  return !result.error && result.status === 0;
+}
+
+function tryPrintTerminalLogo() {
+  if (!process.stdout.isTTY || process.env.CI === 'true' || process.env.GITHUB_ACTIONS === 'true') {
+    return false;
+  }
+
+  if (process.env.TERM_PROGRAM === 'vscode') {
+    return false;
+  }
+
+  const logoPath = path.resolve(__dirname, '../docs/awscfn-logo-light.svg');
+  if (!fs.existsSync(logoPath)) {
+    return false;
+  }
+
+  // Try native terminal image commands (best effort).
+  if (process.env.WEZTERM_PANE && runImageCommand('wezterm', ['imgcat', '--width', '40%', logoPath])) {
+    return true;
+  }
+
+  if (process.env.KITTY_WINDOW_ID && runImageCommand('kitty', ['+kitten', 'icat', '--align', 'left', logoPath])) {
+    return true;
+  }
+
+  if (process.env.ITERM_SESSION_ID && runImageCommand('imgcat', [logoPath])) {
+    return true;
+  }
+
+  return false;
+}
+
+function printLandingHeader() {
+  const boldWhite = '\x1b[1;37m';
+  const gray = '\x1b[90m';
+  const tagline = 'Deploy CloudFormation stacks with confidence.';
+  const hr = maybeColorize('─'.repeat(tagline.length), gray);
+
+  if (!tryPrintTerminalLogo()) {
+    console.log(maybeColorize(ASCII_LOGO.join('\n'), boldWhite));
+  }
+
+  console.log(hr);
+  console.log(tagline);
+  console.log(hr);
+  console.log(maybeColorize('Quick start: awscfn list-stacks | awscfn inspect-stack -n <stack-name>', gray));
+  console.log('');
+}
+
 function logErrorDetails(data) {
   if (data) {
     console.log('\nError details:');
@@ -56,13 +121,162 @@ function logErrorDetails(data) {
   }
 }
 
+function getProfileAwareCommand(baseCommand) {
+  const profile = process.env.AWS_PROFILE;
+  if (!profile) return baseCommand;
+
+  return `${baseCommand} --profile ${profile}`;
+}
+
+function getAwsConfigPath() {
+  if (process.env.AWS_CONFIG_FILE) return process.env.AWS_CONFIG_FILE;
+
+  return path.join(os.homedir(), '.aws', 'config');
+}
+
+function getAwsCredentialsPath() {
+  if (process.env.AWS_SHARED_CREDENTIALS_FILE) return process.env.AWS_SHARED_CREDENTIALS_FILE;
+
+  return path.join(os.homedir(), '.aws', 'credentials');
+}
+
+function readIniSections(filePath) {
+  try {
+    const content = fs.readFileSync(filePath, 'utf8');
+
+    return content
+      .split('\n')
+      .map((line) => line.trim())
+      .filter((line) => line.startsWith('[') && line.endsWith(']'))
+      .map((line) => line.slice(1, -1).trim());
+  } catch {
+    return [];
+  }
+}
+
+function getConfiguredProfiles() {
+  const configSections = readIniSections(getAwsConfigPath())
+    .map((section) => section.startsWith('profile ') ? section.slice('profile '.length) : section);
+  const credentialSections = readIniSections(getAwsCredentialsPath());
+
+  return new Set([...configSections, ...credentialSections]);
+}
+
+function hasCredentialHints() {
+  if (process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY) {
+    return true;
+  }
+
+  const configuredProfiles = getConfiguredProfiles();
+  const requestedProfile = process.env.AWS_PROFILE;
+
+  if (requestedProfile) return configuredProfiles.has(requestedProfile);
+
+  return configuredProfiles.has('default');
+}
+
+function formatRegionOnlyHelp() {
+  const configureCmd = getProfileAwareCommand('aws configure');
+  const showRegionCmd = getProfileAwareCommand('aws configure get region');
+
+  return [
+    'AWS region is not configured.',
+    [
+      'Set a region:',
+      '  • export AWS_REGION=us-east-1',
+      `  • ${configureCmd}`,
+    ].join('\n'),
+    [
+      'Check current region:',
+      `  • ${showRegionCmd}`,
+    ].join('\n'),
+    'Tip: if you use named profiles, set AWS_PROFILE first.',
+  ].join('\n\n');
+}
+
+function formatAuthSetupHelp(profileMissing) {
+  const profile = process.env.AWS_PROFILE;
+  const showRegionCmd = getProfileAwareCommand('aws configure get region');
+  const configureSsoCmd = getProfileAwareCommand('aws configure sso');
+  const ssoLoginCmd = getProfileAwareCommand('aws sso login');
+  const stsCheckCmd = getProfileAwareCommand('aws sts get-caller-identity');
+  const configureCmd = getProfileAwareCommand('aws configure');
+  const profileHint = profile ? `Using AWS profile '${profile}'.` : 'Using default AWS profile.';
+
+  const profileSection = profileMissing && profile
+    ? [
+      `Profile '${profile}' was not found.`,
+      `Create it first: ${configureSsoCmd}`,
+    ].join('\n')
+    : profileHint;
+
+  return [
+    'AWS authentication is not configured for this command yet.',
+    profileSection,
+    'Choose one authentication method:',
+    [
+      'AWS SSO:',
+      `  • ${configureSsoCmd}`,
+      `  • ${ssoLoginCmd}`,
+    ].join('\n'),
+    [
+      'Access keys:',
+      `  • ${configureCmd}  # adds keys + default region`,
+    ].join('\n'),
+    [
+      'Then verify identity:',
+      `  • ${stsCheckCmd}`,
+    ].join('\n'),
+    [
+      'If region is still missing:',
+      '  • export AWS_REGION=us-east-1',
+      `  • ${showRegionCmd}`,
+    ].join('\n'),
+  ].filter(Boolean).join('\n\n');
+}
+
+function formatAuthorizationHelp() {
+  const stsCheckCmd = getProfileAwareCommand('aws sts get-caller-identity');
+
+  return [
+    'AWS authentication succeeded, but this identity does not have enough permissions.',
+    [
+      'Confirm which identity is active:',
+      `  • ${stsCheckCmd}`,
+    ].join('\n'),
+    'Then ask for the required CloudFormation permissions for this account/role.',
+  ].join('\n\n');
+}
+
 function clarifyAwsError(msg) {
-  if (/region\s+is\s+missing|configuration.*region|Missing required key 'region'/i.test(msg)) {
-    return 'AWS region is not set. Set AWS_REGION or AWS_DEFAULT_REGION, or run `aws configure` (or `aws configure sso` if your org uses SSO).';
+  const isRegionMissing = /region\s+is\s+missing|configuration.*region|Missing required key 'region'/i.test(msg);
+  const isCredentialsMissing = /Unable to locate credentials|Could not load credentials|NoCredentialProviders/i.test(msg)
+    || /Token is expired|ExpiredToken|security token included in the request is expired/i.test(msg)
+    || /sso.*expired|refresh failed|SSO session.*invalid|aws sso login/i.test(msg)
+    || /resolved credential object is not valid|credential.*could not be loaded/i.test(msg);
+  const requestedProfile = process.env.AWS_PROFILE;
+  const requestedProfileMissing = Boolean(
+    requestedProfile && !getConfiguredProfiles().has(requestedProfile),
+  );
+  const isProfileMissing = /config profile .* could not be found|profile.*not found/i.test(msg)
+    || requestedProfileMissing;
+
+  if (isRegionMissing && hasCredentialHints() && !isProfileMissing) {
+    return formatRegionOnlyHelp();
   }
-  if (/credentials|Unable to locate credentials|Token is expired/i.test(msg)) {
-    return 'AWS credentials not found or expired. Set AWS_PROFILE, AWS_ACCESS_KEY_ID/secret, or run `aws configure` (or `aws configure sso` if your org uses SSO).';
+
+  if (
+    isRegionMissing
+    || isCredentialsMissing
+    || isProfileMissing
+  ) {
+    return formatAuthSetupHelp(isProfileMissing);
+  }
+
+  if (/AccessDenied|UnauthorizedOperation|is not authorized to perform|AccessDeniedException/i.test(msg)) {
+    return formatAuthorizationHelp();
   }
+
   return msg;
 }
 
@@ -70,11 +284,17 @@ async function runCommand(fn) {
   try {
     await fn();
   } catch (err) {
-    const message = clarifyAwsError(err.message);
-    logError(message);
-    if (message !== err.message) {
-      console.log(`\x1b[90m(original: ${err.message})\x1b[0m`);
+    const originalError = err?.message || String(err);
+    const message = clarifyAwsError(originalError);
+
+    logError(originalError);
+
+    if (message !== originalError) {
+      console.log('');
+      console.log(maybeColorize('Suggested next steps:', '\x1b[36m'));
+      console.log(message);
     }
+
     if (getOutputConfig().verbose) {
       logErrorDetails(err.data);
     }
@@ -113,8 +333,31 @@ const createIfMissingOpt = {
 const confirmOpt = {
   confirm: { type: 'string', alias: 'c', describe: 'Repeat stack name to confirm deletion', demandOption: true },
 };
+const eventsLimitOpt = {
+  events: {
+    type: 'number',
+    alias: 'e',
+    describe: 'Max stack events to fetch (0 means all available events)',
+    demandOption: false,
+    default: 500,
+  },
+};
+const pagerOpt = {
+  pager: {
+    type: 'boolean',
+    describe: 'Open output in a view-only pager (use --no-pager to print directly)',
+    demandOption: false,
+    default: true,
+  },
+};
 
-yargs
+const cli = yargs
+  .scriptName('awscfn')
+  .usage('Usage:\n  $0 <command> [options]')
+  .example('$0 list-stacks', 'List active stacks in the current AWS region')
+  .example('$0 inspect-stack -n my-stack', 'Open a read-only stack inspection view')
+  .example('$0 update-stack -n my-stack -t ./template.yaml -p ./params.yaml', 'Update an existing stack')
+  .epilog('Tip: run `awscfn <command> --help` for command-specific help.')
   .option('ci', {
     type: 'boolean',
     alias: 'C',
@@ -188,6 +431,14 @@ yargs
       runCommand(() => previewStack(name, template, params, require('../dist/cli/parseParamOverrides').parseParamOverrides(set).overrides));
     }
   )
+  .command(
+    'inspect-stack',
+    'Inspect a deployed stack in a read-only pager view',
+    (cmd) => cmd.options({ ...nameOpt, ...eventsLimitOpt, ...pagerOpt }),
+    ({ name, events, pager }) => {
+      runCommand(() => inspectStack(name, { eventsLimit: Number(events), usePager: Boolean(pager) }));
+    }
+  )
   .completion(
     'completion',
     'Generate shell completion script',
@@ -210,5 +461,12 @@ yargs
   .help()
   .alias('h', 'help')
   .version(pkg.version)
-  .alias('v', 'version')
-  .argv;
+  .alias('v', 'version');
+
+if (process.argv.length <= 2) {
+  printLandingHeader();
+  cli.showHelp();
+  process.exit(0);
+}
+
+cli.argv;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './lib/cfn';
 export * from './lib/output';
 export { previewStack } from './previewStack';
+export { inspectStack } from './inspectStack';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -14,9 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.previewStack = void 0;
+exports.inspectStack = exports.previewStack = void 0;
 __exportStar(require("./lib/cfn"), exports);
 __exportStar(require("./lib/output"), exports);
 var previewStack_1 = require("./previewStack");
 Object.defineProperty(exports, "previewStack", { enumerable: true, get: function () { return previewStack_1.previewStack; } });
+var inspectStack_1 = require("./inspectStack");
+Object.defineProperty(exports, "inspectStack", { enumerable: true, get: function () { return inspectStack_1.inspectStack; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,+CAA6B;AAC7B,+CAA4C;AAApC,4GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,+CAA6B;AAC7B,+CAA4C;AAApC,4GAAA,YAAY,OAAA;AACpB,+CAA4C;AAApC,4GAAA,YAAY,OAAA"}

package/dist/inspectStack.d.ts

@@ -0,0 +1,6 @@
+export interface InspectStackOptions {
+    eventsLimit: number;
+    usePager: boolean;
+}
+export declare function inspectStack(stackName: string, options?: Partial<InspectStackOptions>): Promise<void>;
+//# sourceMappingURL=inspectStack.d.ts.map

package/dist/inspectStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectStack.d.ts","sourceRoot":"","sources":["../src/inspectStack.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;CACpB;AAwND,wBAAsB,YAAY,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/inspectStack.js

@@ -0,0 +1,187 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inspectStack = inspectStack;
+const cfn = __importStar(require("./lib/cfn"));
+const viewText_1 = require("./lib/viewText");
+const DEFAULT_OPTIONS = {
+    eventsLimit: 500,
+    usePager: true,
+};
+const GENERIC_FAILURE_PATTERNS = [
+    /resource creation cancelled/i,
+    /resource update cancelled/i,
+    /the following resource\(s\) failed/i,
+    /user initiated/i,
+];
+function toIso(value) {
+    if (!value) {
+        return '—';
+    }
+    return value.toISOString();
+}
+function toTimestamp(event) {
+    return event.Timestamp?.getTime() ?? 0;
+}
+function toChronological(events) {
+    return events.slice().sort((left, right) => toTimestamp(left) - toTimestamp(right));
+}
+function isFailureStatus(status) {
+    return status.includes('FAILED') || status.includes('ROLLBACK');
+}
+function isGenericFailureReason(reason) {
+    return GENERIC_FAILURE_PATTERNS.some((pattern) => pattern.test(reason));
+}
+function getFailureEvents(events) {
+    const out = [];
+    for (const event of events) {
+        const status = event.ResourceStatus ?? '';
+        const reason = event.ResourceStatusReason ?? '';
+        if (!isFailureStatus(status) || !reason)
+            continue;
+        out.push({
+            timestamp: toIso(event.Timestamp),
+            resource: `${event.LogicalResourceId ?? 'Unknown'} (${event.ResourceType ?? 'Unknown'})`,
+            status,
+            reason,
+        });
+    }
+    return out;
+}
+function uniqueRootCauseCandidates(failures) {
+    const seenReasons = new Set();
+    const rootCauses = [];
+    for (const failure of failures) {
+        if (isGenericFailureReason(failure.reason) || seenReasons.has(failure.reason))
+            continue;
+        seenReasons.add(failure.reason);
+        rootCauses.push(failure);
+    }
+    return rootCauses;
+}
+function formatSection(title, body) {
+    return `${title}\n${'-'.repeat(title.length)}\n${body}`;
+}
+function formatParameters(stack) {
+    const params = stack.Parameters ?? [];
+    if (params.length === 0)
+        return 'No parameters on stack.';
+    return params
+        .map((param) => `${param.ParameterKey ?? 'Unknown'}=${param.ParameterValue ?? '(no value returned)'}`)
+        .join('\n');
+}
+function formatOutputs(stack) {
+    const outputs = stack.Outputs ?? [];
+    if (outputs.length === 0)
+        return 'No outputs on stack.';
+    return outputs.map((output) => `${output.OutputKey ?? 'Unknown'}=${output.OutputValue ?? ''}`).join('\n');
+}
+function formatRootCauses(failures) {
+    const rootCauses = uniqueRootCauseCandidates(failures).slice(0, 10);
+    if (rootCauses.length === 0)
+        return 'No specific root-cause errors detected.';
+    return rootCauses
+        .map((failure) => `[${failure.timestamp}] ${failure.status} ${failure.resource}\n  Reason: ${failure.reason}`)
+        .join('\n\n');
+}
+function formatFailureEvents(failures) {
+    if (failures.length === 0)
+        return 'No failure events found.';
+    return failures
+        .slice(-50)
+        .map((failure) => `[${failure.timestamp}] ${failure.status} ${failure.resource}\n  Reason: ${failure.reason}`)
+        .join('\n\n');
+}
+function formatEvent(event) {
+    const timestamp = toIso(event.Timestamp);
+    const status = event.ResourceStatus ?? 'UNKNOWN';
+    const logical = event.LogicalResourceId ?? 'Unknown';
+    const type = event.ResourceType ?? 'Unknown';
+    const reason = event.ResourceStatusReason ? `\n  Reason: ${event.ResourceStatusReason}` : '';
+    return `[${timestamp}] ${status} ${logical} (${type})${reason}`;
+}
+function formatEvents(events, eventsLimit) {
+    if (events.length === 0)
+        return 'No stack events found.';
+    const chronological = toChronological(events);
+    const header = eventsLimit > 0
+        ? `Showing up to ${eventsLimit} events in chronological order.`
+        : 'Showing all events in chronological order.';
+    return `${header}\n\n${chronological.map((event) => formatEvent(event)).join('\n\n')}`;
+}
+function stackDetailsJson(stack) {
+    return JSON.stringify(stack, (_key, value) => value instanceof Date ? value.toISOString() : value, 2);
+}
+function stackSummary(stack) {
+    const lines = [
+        `StackName: ${stack.StackName ?? '—'}`,
+        `StackId: ${stack.StackId ?? '—'}`,
+        `Status: ${stack.StackStatus ?? '—'}`,
+        `StatusReason: ${stack.StackStatusReason ?? '—'}`,
+        `CreatedAt: ${toIso(stack.CreationTime)}`,
+        `UpdatedAt: ${toIso(stack.LastUpdatedTime)}`,
+        `DriftStatus: ${stack.DriftInformation?.StackDriftStatus ?? '—'}`,
+        `EnableTerminationProtection: ${stack.EnableTerminationProtection ?? false}`,
+    ];
+    return lines.join('\n');
+}
+function buildReport(stack, templateBody, events, options) {
+    const failures = getFailureEvents(toChronological(events));
+    const sections = [
+        formatSection('Stack Summary', stackSummary(stack)),
+        formatSection('Stack Details (Raw JSON)', stackDetailsJson(stack)),
+        formatSection('Parameters', formatParameters(stack)),
+        formatSection('Outputs', formatOutputs(stack)),
+        formatSection('Likely Root Causes', formatRootCauses(failures)),
+        formatSection('Failure Events', formatFailureEvents(failures)),
+        formatSection('Events', formatEvents(events, options.eventsLimit)),
+        formatSection('Full Deployed Template', templateBody || 'Template body is empty.'),
+    ];
+    return ['awscfn inspect-stack', '='.repeat(20), '', ...sections].join('\n\n');
+}
+async function inspectStack(stackName, options) {
+    cfn.initCloudFormationClient();
+    const resolvedOptions = { ...DEFAULT_OPTIONS, ...options };
+    const stack = await cfn.getStackByName(stackName, true);
+    if (!stack)
+        throw new Error(`stack ${stackName} does not exist`);
+    const [templateBody, events] = await Promise.all([
+        cfn.getStackTemplateBody(stackName),
+        cfn.listStackEvents(stackName, resolvedOptions.eventsLimit),
+    ]);
+    const report = buildReport(stack, templateBody, events, resolvedOptions);
+    (0, viewText_1.viewText)(`inspect-${stackName}`, report, { usePager: resolvedOptions.usePager });
+}
+//# sourceMappingURL=inspectStack.js.map

package/dist/inspectStack.js.map

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

package/dist/lib/cfn/getStackTemplate.d.ts

@@ -0,0 +1,2 @@
+export declare function getStackTemplateBody(stackName: string): Promise<string>;
+//# sourceMappingURL=getStackTemplate.d.ts.map

package/dist/lib/cfn/getStackTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getStackTemplate.d.ts","sourceRoot":"","sources":["../../../src/lib/cfn/getStackTemplate.ts"],"names":[],"mappings":"AAiCA,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY7E"}

package/dist/lib/cfn/getStackTemplate.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStackTemplateBody = getStackTemplateBody;
+const client_cloudformation_1 = require("@aws-sdk/client-cloudformation");
+const _1 = require(".");
+function toTemplateString(templateBody) {
+    if (typeof templateBody === 'string') {
+        return templateBody;
+    }
+    if (!templateBody) {
+        return '';
+    }
+    return JSON.stringify(templateBody, null, 2);
+}
+async function fetchTemplate(stage, stackName) {
+    const cf = (0, _1.getCfClient)();
+    const response = await cf.send(new client_cloudformation_1.GetTemplateCommand({
+        StackName: stackName,
+        TemplateStage: stage,
+    }));
+    return toTemplateString(response.TemplateBody);
+}
+async function getStackTemplateBody(stackName) {
+    const original = await fetchTemplate('Original', stackName);
+    if (original) {
+        return original;
+    }
+    return fetchTemplate('Processed', stackName);
+}
+//# sourceMappingURL=getStackTemplate.js.map

package/dist/lib/cfn/getStackTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getStackTemplate.js","sourceRoot":"","sources":["../../../src/lib/cfn/getStackTemplate.ts"],"names":[],"mappings":";;AAiCA,oDAYC;AA7CD,0EAAkE;AAClE,wBAA8B;AAE9B,SAAS,gBAAgB,CAAC,YAAqB;IAE3C,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QAEnC,OAAO,YAAY,CAAC;IAExB,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAEhB,OAAO,EAAE,CAAC;IAEd,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAEjD,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,KAA6B,EAAE,SAAiB;IAEzE,MAAM,EAAE,GAAG,IAAA,cAAW,GAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,0CAAkB,CAAC;QAClD,SAAS,EAAE,SAAS;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC,CAAC,CAAC;IAEJ,OAAO,gBAAgB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AAEnD,CAAC;AAEM,KAAK,UAAU,oBAAoB,CAAC,SAAiB;IAExD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAE5D,IAAI,QAAQ,EAAE,CAAC;QAEX,OAAO,QAAQ,CAAC;IAEpB,CAAC;IAED,OAAO,aAAa,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAEjD,CAAC"}

package/dist/lib/cfn/index.d.ts

@@ -18,4 +18,6 @@ export * from './isStackTerminal';
 export * from './waitUntilStackTerminal';
 export * from './getParamFromStack';
 export * from './streamStackEvents';
+export * from './getStackTemplate';
+export * from './listStackEvents';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/cfn/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/cfn/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,gCAAgC,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjD,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,cAAc,IAAI;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,CAAC,CAAA;CACZ,GAAG,MAAM,CAAC;AAIX,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAED,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD;AAED,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/cfn/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,gCAAgC,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjD,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,cAAc,IAAI;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,CAAC,CAAA;CACZ,GAAG,MAAM,CAAC;AAIX,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAED,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD;AAED,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/lib/cfn/index.js

@@ -38,4 +38,6 @@ __exportStar(require("./isStackTerminal"), exports);
 __exportStar(require("./waitUntilStackTerminal"), exports);
 __exportStar(require("./getParamFromStack"), exports);
 __exportStar(require("./streamStackEvents"), exports);
+__exportStar(require("./getStackTemplate"), exports);
+__exportStar(require("./listStackEvents"), exports);
 //# sourceMappingURL=index.js.map

package/dist/lib/cfn/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/cfn/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAUA,4DAIC;AAED,kCAMC;AAtBD,0EAAoE;AAQpE,IAAI,EAAkC,CAAC;AAEvC,SAAgB,wBAAwB;IAEpC,EAAE,GAAG,IAAI,4CAAoB,EAAE,CAAC;AAEpC,CAAC;AAED,SAAgB,WAAW;IAEvB,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAElE,OAAO,EAAE,CAAC;AAEd,CAAC;AAED,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,qDAAmC;AACnC,gDAA8B;AAC9B,gDAA8B;AAC9B,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/cfn/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAUA,4DAIC;AAED,kCAMC;AAtBD,0EAAoE;AAQpE,IAAI,EAAkC,CAAC;AAEvC,SAAgB,wBAAwB;IAEpC,EAAE,GAAG,IAAI,4CAAoB,EAAE,CAAC;AAEpC,CAAC;AAED,SAAgB,WAAW;IAEvB,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAElE,OAAO,EAAE,CAAC;AAEd,CAAC;AAED,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,qDAAmC;AACnC,gDAA8B;AAC9B,gDAA8B;AAC9B,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC;AACpC,qDAAmC;AACnC,oDAAkC"}

package/dist/lib/cfn/listStackEvents.d.ts

@@ -0,0 +1,3 @@
+import { StackEvent } from '@aws-sdk/client-cloudformation';
+export declare function listStackEvents(stackName: string, limit?: number): Promise<StackEvent[]>;
+//# sourceMappingURL=listStackEvents.d.ts.map

package/dist/lib/cfn/listStackEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listStackEvents.d.ts","sourceRoot":"","sources":["../../../src/lib/cfn/listStackEvents.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,UAAU,EAAC,MAAM,gCAAgC,CAAC;AAetF,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAoBnG"}

package/dist/lib/cfn/listStackEvents.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listStackEvents = listStackEvents;
+const client_cloudformation_1 = require("@aws-sdk/client-cloudformation");
+const _1 = require(".");
+function trimToLimit(events, limit) {
+    if (limit <= 0) {
+        return events;
+    }
+    return events.slice(0, limit);
+}
+async function listStackEvents(stackName, limit = 500) {
+    const cf = (0, _1.getCfClient)();
+    const events = [];
+    let nextToken;
+    do {
+        const response = await cf.send(new client_cloudformation_1.DescribeStackEventsCommand({
+            StackName: stackName,
+            NextToken: nextToken,
+        }));
+        events.push(...(response.StackEvents ?? []));
+        nextToken = response.NextToken;
+    } while (nextToken && (limit <= 0 || events.length < limit));
+    return trimToLimit(events, limit);
+}
+//# sourceMappingURL=listStackEvents.js.map

package/dist/lib/cfn/listStackEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listStackEvents.js","sourceRoot":"","sources":["../../../src/lib/cfn/listStackEvents.ts"],"names":[],"mappings":";;AAeA,0CAoBC;AAnCD,0EAAsF;AACtF,wBAA8B;AAE9B,SAAS,WAAW,CAAC,MAAoB,EAAE,KAAa;IAEpD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAEb,OAAO,MAAM,CAAC;IAElB,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAElC,CAAC;AAEM,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,QAAgB,GAAG;IAExE,MAAM,EAAE,GAAG,IAAA,cAAW,GAAE,CAAC;IACzB,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,SAA2B,CAAC;IAEhC,GAAG,CAAC;QAEA,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,kDAA0B,CAAC;YAC1D,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,SAAS;SACvB,CAAC,CAAC,CAAC;QAEJ,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7C,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;IAEnC,CAAC,QAAQ,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE;IAE7D,OAAO,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEtC,CAAC"}

package/dist/lib/viewText.d.ts

@@ -0,0 +1,5 @@
+export interface ViewTextOptions {
+    usePager: boolean;
+}
+export declare function viewText(reportName: string, content: string, options: ViewTextOptions): void;
+//# sourceMappingURL=viewText.d.ts.map

package/dist/lib/viewText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewText.d.ts","sourceRoot":"","sources":["../../src/lib/viewText.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,OAAO,CAAA;CACpB;AA2DD,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAyB5F"}

package/dist/lib/viewText.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.viewText = viewText;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+function runViewerCommand(command, args) {
+    const result = (0, node_child_process_1.spawnSync)(command, args, { stdio: 'inherit' });
+    return !result.error && result.status === 0;
+}
+function runPagerExpression(pagerExpression, filePath) {
+    const result = (0, node_child_process_1.spawnSync)(`${pagerExpression} "${filePath}"`, {
+        shell: true,
+        stdio: 'inherit',
+    });
+    return !result.error && result.status === 0;
+}
+function openWithPager(filePath) {
+    const pagerExpression = process.env.GIT_PAGER ?? process.env.PAGER;
+    if (pagerExpression && runPagerExpression(pagerExpression, filePath)) {
+        return true;
+    }
+    return runViewerCommand('less', ['-R', filePath]) || runViewerCommand('more', [filePath]);
+}
+function writeTempReport(reportName, content) {
+    const tempDir = (0, node_fs_1.mkdtempSync)(node_path_1.default.join((0, node_os_1.tmpdir)(), 'awscfn-'));
+    const safeName = reportName.replace(/[^a-zA-Z0-9-]/g, '-');
+    const filePath = node_path_1.default.join(tempDir, `${safeName}.txt`);
+    (0, node_fs_1.writeFileSync)(filePath, content, 'utf8');
+    return filePath;
+}
+function readAndPrint(filePath) {
+    console.log((0, node_fs_1.readFileSync)(filePath, 'utf8'));
+}
+function shouldPrintInline(usePager) {
+    return !usePager || !process.stdout.isTTY || process.env.CI === 'true' || process.env.GITHUB_ACTIONS === 'true';
+}
+function viewText(reportName, content, options) {
+    if (shouldPrintInline(options.usePager)) {
+        console.log(content);
+        return;
+    }
+    const filePath = writeTempReport(reportName, content);
+    try {
+        if (!openWithPager(filePath)) {
+            readAndPrint(filePath);
+        }
+    }
+    finally {
+        (0, node_fs_1.rmSync)(node_path_1.default.dirname(filePath), { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=viewText.js.map

package/dist/lib/viewText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewText.js","sourceRoot":"","sources":["../../src/lib/viewText.ts"],"names":[],"mappings":";;;;;AAkEA,4BAyBC;AA3FD,qCAAyE;AACzE,qCAA+B;AAC/B,0DAA6B;AAC7B,2DAA6C;AAM7C,SAAS,gBAAgB,CAAC,OAAe,EAAE,IAAc;IAErD,MAAM,MAAM,GAAG,IAAA,8BAAS,EAAC,OAAO,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,SAAS,EAAC,CAAC,CAAC;IAE5D,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;AAEhD,CAAC;AAED,SAAS,kBAAkB,CAAC,eAAuB,EAAE,QAAgB;IAEjE,MAAM,MAAM,GAAG,IAAA,8BAAS,EAAC,GAAG,eAAe,KAAK,QAAQ,GAAG,EAAE;QACzD,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,SAAS;KACnB,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;AAEhD,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IAEnC,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;IAEnE,IAAI,eAAe,IAAI,kBAAkB,CAAC,eAAe,EAAE,QAAQ,CAAC,EAAE,CAAC;QAEnE,OAAO,IAAI,CAAC;IAEhB,CAAC;IAED,OAAO,gBAAgB,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE9F,CAAC;AAED,SAAS,eAAe,CAAC,UAAkB,EAAE,OAAe;IAExD,MAAM,OAAO,GAAG,IAAA,qBAAW,EAAC,mBAAI,CAAC,IAAI,CAAC,IAAA,gBAAM,GAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,MAAM,CAAC,CAAC;IAEvD,IAAA,uBAAa,EAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEzC,OAAO,QAAQ,CAAC;AAEpB,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IAElC,OAAO,CAAC,GAAG,CAAC,IAAA,sBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhD,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAiB;IAExC,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,CAAC;AAEpH,CAAC;AAED,SAAgB,QAAQ,CAAC,UAAkB,EAAE,OAAe,EAAE,OAAwB;IAElF,IAAI,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAEtC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO;IAEX,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEtD,IAAI,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YAE3B,YAAY,CAAC,QAAQ,CAAC,CAAC;QAE3B,CAAC;IAEL,CAAC;YAAS,CAAC;QAEP,IAAA,gBAAM,EAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC;IAEnE,CAAC;AAEL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "awscfn",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "CLI and TypeScript SDK for managing AWS CloudFormation stacks with simple YAML parameters and real-time event streaming.",
   "type": "commonjs",
   "main": "./dist/index.js",