Skip to content

Make help text honestly AWS-only; add a cloud parity matrix#23

Merged
stxkxs merged 1 commit into
mainfrom
uplift-honest-aws-only
Jun 5, 2026
Merged

Make help text honestly AWS-only; add a cloud parity matrix#23
stxkxs merged 1 commit into
mainfrom
uplift-honest-aws-only

Conversation

@stxkxs

@stxkxs stxkxs commented Jun 5, 2026

Copy link
Copy Markdown
Member

What

cloudgov is AWS-native today; its provider seams are multi-cloud-shaped but no GCP/Azure provider is implemented. A few command help strings overstated that, and the README had no statement of which clouds each command covers.

Help text

Rewrote command help that used generic cloud/across providers to name AWS:

  • inventory — "List all cloud resources across providers" → "List all AWS resources" (Short + Long).
  • quota — "…across cloud providers" → "Check AWS service quota utilization vs limits".
  • secrets / secrets scan — dropped the false GCP "Cloud Functions" and Azure "App Service settings" scan targets; the scanner only reads AWS surfaces (Lambda env, ECS task defs, EC2 user data, SSM params, CloudFormation outputs), now listed accurately. (It still detects leaked GCP/Azure credentials embedded in those AWS surfaces — a finding type, not a scan target.)
  • cost / orphans / drift — "cloud" → "AWS" for consistency.

Parity matrix

README gains a ## Cloud support section: a short statement that the tool is AWS-native with a pluggable provider seam (capability interfaces + registry) making GCP/Azure additive, plus a command × cloud matrix (✅ implemented · ⬡ seam-ready · — n/a) — AWS full across all domains, GCP/Azure seam-ready, k8s for RBAC; offline commands + mcp noted as cloud-agnostic. The pluggable-seam framing (the intentional design) is kept; only present-tense multi-cloud claims were removed.

How it was found / verified

  • Audit workflow (4 parallel read-only sweeps): confirmed the README headline was already honest, surfaced the subtle help-string overclaims, and enumerated the 22-command matrix material from the code.
  • Adversarial review workflow (honesty-completeness + matrix-accuracy dimensions → verify stage): confirmed no overclaim survived and every matrix row is accurate; its 4 LOW nits are fixed here (inventory/drift H3 headings, cost/orphans/drift Shorts, the Platform footnote — corrected from "RBAC" to IRSA + tenant cluster objects — and mcp added to the matrix note).

Docs-only + help strings; task build / go test ./... / go vet green. Completes backlog T8.

cloudgov is AWS-native today; its provider seams are multi-cloud-shaped but
no GCP/Azure provider is implemented. A few command help strings overstated
that, and the README had no statement of which clouds each command covers.

──────────────────────── help text ────────────────────────

Rewrote the command help that used generic "cloud"/"across providers"
phrasing to name AWS:
  - inventory: "List all cloud resources across providers" -> "List all AWS
    resources" (Short + Long).
  - quota: "...across cloud providers" -> "Check AWS service quota
    utilization vs limits".
  - secrets / secrets scan: dropped the false GCP "Cloud Functions" and
    Azure "App Service settings" scan targets; the scanner only reads AWS
    surfaces (Lambda env, ECS task defs, EC2 user data, SSM params,
    CloudFormation outputs), now listed accurately. (It still DETECTS leaked
    GCP/Azure credentials embedded in those AWS surfaces — a finding type,
    not a scan target.)
  - cost / orphans / drift: "cloud" -> "AWS" for consistency.

──────────────────────── parity matrix ────────────────────────

README gains a "Cloud support" section: a short statement that the tool is
AWS-native with a pluggable provider seam (capability interfaces + registry)
that makes GCP/Azure additive, plus a command x cloud matrix marking each
domain implemented (AWS), seam-ready (GCP/Azure), or n/a (k8s for RBAC).
Offline commands and the mcp server are noted as cloud-agnostic.

Found via an audit workflow (the headline was already honest — the overclaims
were subtle) and verified by an adversarial review workflow (no overclaim
survived; every matrix row checked against the code).
@stxkxs stxkxs merged commit 029c6a3 into main Jun 5, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant