cloudburn 0.18.3 → 0.18.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +26 -0
  2. package/dist/cli.js +1 -1
  3. package/package.json +7 -7
package/README.md CHANGED
@@ -163,6 +163,32 @@ rules finish. Each rule line includes its ID, status, and finding count. Provisi
163
163
  far; the final report and exit code are authoritative. Progress is silent when `stderr` is not a terminal or `--debug`
164
164
  is enabled. `--format json` writes one final JSON result to `stdout`.
165
165
 
166
+ #### Discovery JSON capabilities
167
+
168
+ `cloudburn --format json discover` includes a top-level `capabilities` array in the final scan result. It is present
169
+ for live discovery even when empty; static `cloudburn --format json scan` results omit it. An absent capability was
170
+ not assessed and must not be treated as ready.
171
+
172
+ Each entry contains `capability`, `status`, bounded `reasons`, `scope`, and contributing `datasetKeys`. Status describes
173
+ evidence readiness, not whether a rule passed:
174
+
175
+ - `available`: the requested datasets loaded, including successful empty responses.
176
+ - `partial`: some usable evidence exists, but a dataset or Region failed or coverage is incomplete.
177
+ - `unavailable`: required setup, enrollment, access, or usable source data is missing, or no applicable resources ran.
178
+ - `error`: no usable evidence exists after a service error or throttling.
179
+
180
+ Reasons such as `not-enrolled`, `access-denied`, `data-unavailable`, and `not-assessed` distinguish those cases without
181
+ parsing diagnostic text. Account scope applies to account-level evidence; regional scope lists Regions where the
182
+ mapped dataset observed resources or failed, falling back to the requested Region when nothing was observed.
183
+ `recommendation-source` scope describes only the account and optional Region of returned Hub records, not current
184
+ upstream enrollment or complete coverage. The shared SDK contract also supports `all-regions` as an unobserved
185
+ all-Region target fallback; the CLI itself targets one Region per run.
186
+
187
+ These outcomes reuse collected evidence and do not change AWS enrollment or setup. A successful regional catalog
188
+ does not prove aggregator-backed account-wide tagging readiness. Capability failures do not erase unrelated findings.
189
+ See the [capability result reference](../../docs/reference/finding-shape.md#awscapabilityoutcome) for the complete
190
+ identifier, reason, and scope contracts.
191
+
166
192
  ## Shell Completion
167
193
 
168
194
  Inspect the available completion subcommands:
package/dist/cli.js CHANGED
@@ -1604,7 +1604,7 @@ var isCliEntrypoint = (moduleUrl, argvEntry = process.argv[1]) => {
1604
1604
  };
1605
1605
  var createProgram = () => {
1606
1606
  const program = createCliCommand();
1607
- program.name("cloudburn").usage("[command]").description("Know what you spend. Fix what you waste.").version("0.18.3").option("--debug", "Write execution trace messages to stderr").option("--format <format>", OUTPUT_FORMAT_OPTION_DESCRIPTION, parseOutputFormat);
1607
+ program.name("cloudburn").usage("[command]").description("Know what you spend. Fix what you waste.").version("0.18.5").option("--debug", "Write execution trace messages to stderr").option("--format <format>", OUTPUT_FORMAT_OPTION_DESCRIPTION, parseOutputFormat);
1608
1608
  configureCliHelp(program);
1609
1609
  program.exitOverride();
1610
1610
  registerCompletionCommand(program);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cloudburn",
3
- "version": "0.18.3",
3
+ "version": "0.18.5",
4
4
  "description": "Cloudburn CLI for cloud cost optimization",
5
5
  "homepage": "https://cloudburn.io/docs",
6
6
  "bugs": {
@@ -19,16 +19,16 @@
19
19
  "dist"
20
20
  ],
21
21
  "dependencies": {
22
- "commander": "^13.1.0",
23
- "@cloudburn/sdk": "0.36.0"
22
+ "commander": "^15.0.0",
23
+ "@cloudburn/sdk": "0.37.0"
24
24
  },
25
25
  "devDependencies": {
26
- "@biomejs/biome": "^2.5.3",
27
- "@types/node": "^24",
28
- "@vitest/coverage-v8": "^4.0.18",
26
+ "@biomejs/biome": "^2.5.12",
27
+ "@types/node": "^24.13.3",
28
+ "@vitest/coverage-v8": "^5.0.0",
29
29
  "tsup": "^8.5.1",
30
30
  "typescript": "5.9.3",
31
- "vitest": "^4.0.18"
31
+ "vitest": "^5.0.0"
32
32
  },
33
33
  "keywords": [
34
34
  "aws",