# AWS Cost Optimization Toolkit Catalog

This is the static catalog content for the AWS Cost Optimization Toolkit.

## Current checkpoint

Phase 1 is complete:

- Private S3 bucket
- CloudFront distribution
- CloudFront Origin Access Control
- Security-managed S3 bucket policy preserved and merged
- Static catalog page
- Manifest-driven tool list
- YAML downloads through CloudFront

The catalog does not require S3 static website hosting.

## Publish

```powershell
aws s3 sync .\catalog-publish\ s3://<CatalogBucketName>/ --delete
aws cloudfront create-invalidation --distribution-id <DistributionId> --paths "/*"
```

## Folder layout

```text
catalog-publish/
  index.html
  manifest.json
  README.md
  404.html
  remediation-tools/
  report-generator/
  docs/
  scripts/
```

## Operating model

The assessment report remains read-only. Remediation modules are separate, opt-in CloudFormation tools with conservative defaults.

Security-owned services and centrally managed logging should remain visible in reports but are generally advisory-only unless the owning team approves changes.


## User workflow

Open `getting-started.html` from the catalog for the recommended operator workflow.

## Report generator

The read-only report generator template should be published as:

```text
report-generator/Cost-Optimization-Report-Template-V1.yaml
```


## Catalog update process

The catalog update and troubleshooting process is published at:

```text
docs/catalog-update-process.md
```

This includes validation checks for manifest/file mismatches, folder index links, S3 sync `--delete`, and CloudFront invalidations.