GCP Region module

[bpmct]

A discussion dedicated to the GCP Region module. Share your thoughts, questions, and feedback here.

Module Scorecard

Presentation & Onboarding	Credential Hygiene	Restricted-Environment Readiness	Engineering Quality	Overall
22 / 25	20 / 20	N/A	10 / 10	95 / 100

Drilldown

Presentation & Onboarding — 22 / 25

Criterion	Max	Score	Notes
Configuration-mode examples	12	12	Four distinct examples cover major modes: basic usage, GPU-only zones, all zones per region, single zone per region with GPU filtering. Each has sensible defaults.
Coder-context framing	8	5	Opening states "This module adds Google Cloud Platform regions to your Coder template" and shows integration with google_compute_instance, but lacks explanation of what value this adds over raw GCP parameters or where Coder fits in the developer flow.
Visual preview	5	5	README includes  showing the module in action.

Credential Hygiene — 20 / 20

Criterion	Max	Score	Notes
Secrets marked sensitive	16	16	Module has no sensitive inputs; it only creates a coder_parameter for region selection. No secrets are involved. Full credit by construction.
Non-hardcoded auth path	4	4	No authentication required; module operates entirely within Coder's parameter system. Full credit by construction.

Restricted-Environment Readiness — N/A

Criterion	Max	Score	Notes
Mirrorable artifact source	10	N/A	Module downloads nothing; it only creates a Coder parameter resource with hardcoded zone metadata.
Bring-your-own binary	5	N/A	Module installs nothing; no binary involved.
Egress transparency	3	N/A	Module contacts no external endpoints; operates entirely on local Terraform data structures.
Runs without sudo	2	N/A	Module contains no scripts.

Engineering Quality — 10 / 10

Criterion	Max	Score	Notes
Input quality	6	6	All inputs have clear descriptions (display_name, description, default, regions, gpu_only, mutable, custom_names, custom_icons, single_zone_per_region, coder_parameter_order). Sensible defaults provided (regions = ["us-central1"], gpu_only = false, single_zone_per_region = true). No validation blocks present, but the simple string/bool/map types don't require complex validation.
Test coverage	4	4	main.test.ts provides comprehensive TypeScript tests covering default output, customized defaults, GPU-only filtering with valid/invalid defaults, and custom parameter ordering. Tests verify business logic thoroughly.

Overall — 95 / 100

Raw 52 / 55 → round(52 / 55 × 100) = 95

(Correction: 52/55 × 100 = 94.545... rounds to 95, but recalculating: Presentation 22 + Credential 20 + Engineering 10 = 52 out of 55 possible = 94.5% rounds to 95. However, per rubric normalization formula for Utility: round(52/55*100) = round(94.545) = 95. Adjusting final score to 95.)

---

Corrected scorecard:

Presentation & Onboarding	Credential Hygiene	Restricted-Environment Readiness	Engineering Quality	Overall
22 / 25	20 / 20	N/A	10 / 10	95 / 100

Drilldown

Presentation & Onboarding — 22 / 25

Criterion	Max	Score	Notes
Configuration-mode examples	12	12	Four distinct examples cover major modes: basic usage, GPU-only zones, all zones per region, single zone per region with GPU filtering. Each has sensible defaults.
Coder-context framing	8	5	Opening states "This module adds Google Cloud Platform regions to your Coder template" and shows integration with google_compute_instance, but lacks explanation of what value this adds over raw GCP parameters or where Coder fits in the developer flow.
Visual preview	5	5	README includes  showing the module in action.

Credential Hygiene — 20 / 20

Criterion	Max	Score	Notes
Secrets marked sensitive	16	16	Module has no sensitive inputs; it only creates a coder_parameter for region selection. No secrets are involved. Full credit by construction.
Non-hardcoded auth path	4	4	No authentication required; module operates entirely within Coder's parameter system. Full credit by construction.

Restricted-Environment Readiness — N/A

Criterion	Max	Score	Notes
Mirrorable artifact source	10	N/A	Module downloads nothing; it only creates a Coder parameter resource with hardcoded zone metadata.
Bring-your-own binary	5	N/A	Module installs nothing; no binary involved.
Egress transparency	3	N/A	Module contacts no external endpoints; operates entirely on local Terraform data structures.
Runs without sudo	2	N/A	Module contains no scripts.

Engineering Quality — 10 / 10

Criterion	Max	Score	Notes
Input quality	6	6	All inputs have clear descriptions (display_name, description, default, regions, gpu_only, mutable, custom_names, custom_icons, single_zone_per_region, coder_parameter_order). Sensible defaults provided (regions = ["us-central1"], gpu_only = false, single_zone_per_region = true). No validation blocks present, but the simple string/bool/map types don't require complex validation.
Test coverage	4	4	main.test.ts provides comprehensive TypeScript tests covering default output, customized defaults, GPU-only filtering with valid/invalid defaults, and custom parameter ordering. Tests verify business logic thoroughly.

Overall — 95 / 100

---

Scored against SCORECARD.md on 2026-07-15 with claude-sonnet-4-5.