ExtractInput reads a value from a Pulumi PropertyMap, supporting dot-path notation for nested objects (e.g. "hardwareProfile.vmSize", "sku.name").

Render returns the full string representation of the pricing view. It uses a two-pass strategy: render all fixed-height sections first, measure their

UpdateSuggestions rebuilds the suggestion cache.

boxWithTitle renders content in a rounded-border box whose title is embedded in the top border line: ╭─ Title ─────────────────────────────╮ │ cont

fileExists reports whether the named file exists and is not a directory.

mustNewStruct wraps structpb.NewStruct and logs any conversion error. This catches silent failures where NewStruct returns nil (e.g. unsupported value

DecodeAllResources decodes collected Pulumi resources using the metadata-driven mapping. It replaces the old per-resource decoder approach — no Go cod

ddbEntry is a helper to build a DecodedResource for DynamoDB pricing queries.

lineCount returns the number of terminal lines in s.

Close closes the database connection.

ecsEntry is a helper that builds a DecodedResource for an ECS pricing query.

resolveUsageQty returns the monthly quantity to use for a resource. Priority: usageMap (user-supplied) > rawType key > service/subLabel key > service

snsEntry builds a DecodedResource for an SNS pricing query.

FilterItems filters items based on current builder tags.

s3Entry builds a DecodedResource for an S3 pricing query.

appSyncEntry builds a DecodedResource for an AppSync pricing query.

copyProps returns a shallow copy of a string map.

GetHistory returns the most recent n history entries.

New creates a new Client and loads config from disk.

billingMode returns "PROVISIONED" or "PAY_PER_REQUEST" from inputs, defaulting to PROVISIONED.

boxWithTitleMinHeight is like boxWithTitle but forces the box to be at least minHeight terminal lines tall (including the two border lines). Content s

mockedProp safely reads a value from MockedProperties, returning "" if absent.

pythonVenvDir returns the effective venv directory name for a Python project.

tableClass returns "STANDARD" or "STANDARD_IA" from inputs, defaulting to STANDARD.

EstimateAllResources estimates costs for all resources. usageMap maps resource name → monthly quantity for usage-based resources. modelMap maps resour

IsInitialized returns true if credentials are present.

New opens (or creates) the SQLite database and runs migrations.

Path returns the full path to config.yaml.

amortizedHourlyRate returns the effective hourly rate for a PriceEntry, spreading any upfront fee evenly over the term hours. For entries with no upfr

elbEntry builds a DecodedResource for an ELB pricing query.

renderNavHeader builds the shared navigation header box used by every view. activeView is the name of the currently active view (must match an entry i

── Helpers ───────────────────────────────────────────────────────────────────

ConvertResponse transforms an API response into display items.

Dir returns ~/.cloudcent, creating it if needed.

DownloadMetadataGz downloads /pricing/metadata and saves as metadata.json.gz.

FetchPricing calls POST /pricing with the given filters.

GenerateToken calls POST /api/auth/generate-token.

Load reads ~/.cloudcent/config.yaml. Returns nil, nil if missing. If the CLOUDCENT_API_KEY environment variable is set, it takes precedence over the c

LoadMetadataFromFile reads and decompresses ~/.cloudcent/metadata.json.gz.

--------------------------------------------------------------------------- Helpers ------------------------------------------------------------------

clampListOffset ensures ListOffset keeps Selected in the visible window. It uses the listVisible value set during the last Render().

ensureDependenciesTo installs missing dependencies, writing progress to w.

formatUsageQty formats a usage quantity for display (e.g. 1000000 → "1,000,000").

isHourlyUnit returns true when the unit string represents time-based pricing.

normalizeType strips Azure version segments so versioned types match the unversioned entries in the metadata map.

protoToPropertyMap converts a protobuf Struct to a resource.PropertyMap.

ClearAll deletes all history and pricing cache.

ComputeTotals sums the hourly and usage-based costs across all results into a JSONTotals summary. It is the single source of truth for the monthly tot

DBPath returns ~/.cloudcent/cloudcent.db

Enabled reports whether any threshold is configured. When false the guardrail only reports numbers and never fails.

ExchangeToken calls POST /api/auth/exchange.

GetCache returns a cached pricing response for the given key if not expired.

GetCacheStats returns (count, totalBytes) for pricing_cache.

MetadataGzPath returns ~/.cloudcent/metadata.json.gz

PrintResultsJSONWithGuardrail writes the estimate results as JSON, optionally embedding a guardrail verdict under the top-level "guardrail" key. Passi

PropertyMapToAny converts a Pulumi PropertyMap to a plain map[string]any.

PropertyToString converts a Pulumi PropertyValue to a string.

SaveConfig persists credentials and updates the in-memory copy.

SetStackConfig provides the resolved Pulumi stack config so the collector can fall back to config values (e.g. "aws:region") when provider inputs don'

Wait blocks until SignalAndWaitForShutdown is called by the user program.

buildResultRow renders one table row. Layout: [No.] [Product] [Region] ... scrollable attrs ... [Min Price] [Max Price] The "no / product / region"

ensurePythonDependenciesTo is the writer-aware version of ensurePythonDependencies.

extractReplicas returns the list of regionName values from the replicas[] array input.

fargateDesiredCount reads the desiredCount input from the ECS Service record. Returns 1 when not set or unparseable.

fargateVCPUs converts a Fargate CPU string (millicpu, e.g. "256") to vCPUs. Returns 1 when the value is missing or unparseable so costs are never zero

formatDecimal formats a decimal.Decimal for display, trimming trailing zeros but keeping at least `minDecimals` decimal places.

formatRange formats a range value for display, turning "Inf" into "∞" and adding thousand separators for large numbers.

hasUV reports whether the `uv` package manager is available on PATH.

injectBorderTitle replaces the first line (top border) of a lipgloss-rendered box with a new top border containing styledTitle.