{"id":50453985,"url":"https://github.com/mizcausevic-dev/bigquery-query-cost-watch","last_synced_at":"2026-06-01T01:05:31.347Z","repository":{"id":360835529,"uuid":"1251861043","full_name":"mizcausevic-dev/bigquery-query-cost-watch","owner":"mizcausevic-dev","description":"BigQuery operator surface for query-cost governance, slot pressure, attribution hygiene, and optimization sequencing.","archived":false,"fork":false,"pushed_at":"2026-05-28T03:36:33.000Z","size":441,"stargazers_count":0,"open_issues_count":10,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T05:04:05.642Z","etag":null,"topics":["bigquery","data-platform","finops","google-cloud","query-governance","typescript"],"latest_commit_sha":null,"homepage":"https://bigquery.kineticgain.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mizcausevic-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-28T01:21:59.000Z","updated_at":"2026-05-28T03:36:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mizcausevic-dev/bigquery-query-cost-watch","commit_stats":null,"previous_names":["mizcausevic-dev/bigquery-query-cost-watch"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/mizcausevic-dev/bigquery-query-cost-watch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fbigquery-query-cost-watch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fbigquery-query-cost-watch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fbigquery-query-cost-watch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fbigquery-query-cost-watch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mizcausevic-dev","download_url":"https://codeload.github.com/mizcausevic-dev/bigquery-query-cost-watch/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mizcausevic-dev%2Fbigquery-query-cost-watch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33755379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bigquery","data-platform","finops","google-cloud","query-governance","typescript"],"created_at":"2026-06-01T01:05:31.286Z","updated_at":"2026-06-01T01:05:31.339Z","avatar_url":"https://github.com/mizcausevic-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bigquery-query-cost-watch\n\n[![CI](https://github.com/mizcausevic-dev/bigquery-query-cost-watch/actions/workflows/ci.yml/badge.svg)](https://github.com/mizcausevic-dev/bigquery-query-cost-watch/actions/workflows/ci.yml)\n[![Deploy](https://github.com/mizcausevic-dev/bigquery-query-cost-watch/actions/workflows/pages.yml/badge.svg)](https://github.com/mizcausevic-dev/bigquery-query-cost-watch/actions/workflows/pages.yml)\n\nOperator control plane for BigQuery query-cost posture, bytes-scanned spikes, slot pressure, attribution drift, telemetry gaps, and optimization sequencing.\n\n## Production status\n\n| Aspect | Status |\n|--------|--------|\n| Deploy | Static prerender -\u003e **https://bigquery.kineticgain.com/** |\n| Data posture | Synthetic INFORMATION_SCHEMA and billing-export samples only; no project identifiers, dataset IDs, or live query logs are committed |\n\n## Why this matters\n\n- BigQuery spend gets dangerous when scan spikes, partition misses, slot contention, and unlabeled workloads stay trapped in raw exports instead of one operator-readable surface.\n- Recruiters looking for `BigQuery / FinOps / data platform / optimization` proof should see a real operator dashboard, not a keyword page.\n- This repo turns BigQuery usage and optimization drift into a control plane for scan containment, reservation hygiene, attribution trust, telemetry continuity, and workload-rightsizing posture.\n\n## Why this matters (KG Embedded tie-back)\n\nThis repo demonstrates the query-cost and optimization-control-plane primitive for Kinetic Gain Embedded: workload snapshots, bytes-scanned evidence, attribution hygiene, and remediation packets in one operator surface. Kinetic Gain Embedded extends this pattern into productized in-app dashboards where platform, FinOps, and analytics teams need evidence-rich cost governance without exposing raw admin consoles or live warehouse credentials.\n\n## What it shows\n\n- `query-lane` visibility for scan efficiency, slot governance, attribution hygiene, and telemetry freshness\n- `cost-risks` detection for bytes-scanned spikes, partition misses, reservation drift, stale snapshots, and export gaps\n- `optimization-posture` packets that tie owner, blocker, timing, and completeness together\n- offline-safe analysis of captured BigQuery usage exports\n- recruiter-facing BigQuery / FinOps / data-platform proof that complements the Microsoft, AWS, GCP, and reporting lanes\n\n## Routes\n\n- `/`\n- `/query-lane`\n- `/cost-risks`\n- `/optimization-posture`\n- `/verification`\n- `/docs`\n\n## API\n\n- `/api/dashboard/summary`\n- `/api/query-lane`\n- `/api/cost-risks`\n- `/api/optimization-posture`\n- `/api/verification`\n- `/api/sample`\n\n## Screenshots\n\n![Overview proof](./screenshots/01-overview-proof.png)\n![Query lane](./screenshots/02-query-lane-proof.png)\n![Cost risks](./screenshots/03-cost-risks-proof.png)\n![Optimization posture](./screenshots/04-optimization-posture-proof.png)\n\n## CLI\n\n```powershell\nnpx bigquery-query-cost-watch fixtures/bigquery-query-hotspots.json `\n  --format markdown `\n  --fail-on-high\n```\n\n## Validation\n\n- `npm run verify`\n- `npm run prerender`\n- `npm run render:assets`\n\n## Local development\n\n```powershell\ncd bigquery-query-cost-watch\nnpm install\nnpm run dev\n```\n\nThen open:\n\n- [http://127.0.0.1:5524/](http://127.0.0.1:5524/)\n- [http://127.0.0.1:5524/query-lane](http://127.0.0.1:5524/query-lane)\n- [http://127.0.0.1:5524/cost-risks](http://127.0.0.1:5524/cost-risks)\n- [http://127.0.0.1:5524/optimization-posture](http://127.0.0.1:5524/optimization-posture)\n\n## Packaging\n\n| Item | Value |\n|---|---|\n| License | `AGPL-3.0-or-later` |\n| CNAME | `bigquery.kineticgain.com` |\n| Live site | [https://bigquery.kineticgain.com/](https://bigquery.kineticgain.com/) |\n| Deploy | Static prerender -\u003e GitHub Pages |\n\n## Docs\n\n- [docs/KINETIC_GAIN_EMBEDDED.md](./docs/KINETIC_GAIN_EMBEDDED.md)\n\n## Related\n\n- [**`gcp-billing-anomaly-router`**](https://github.com/mizcausevic-dev/gcp-billing-anomaly-router) — GCP cost anomaly routing lane\n- [**`regulatory-reporting-mart`**](https://github.com/mizcausevic-dev/regulatory-reporting-mart) — reporting and warehouse proof\n- [**`snowflake-cost-governance-studio`**](https://github.com/mizcausevic-dev/snowflake-cost-governance-studio) — warehouse cost governance on Snowflake\n\n## Part of the Kinetic Gain Suite\n\nOperator surface in the [Kinetic Gain Suite](https://suite.kineticgain.com/) — a portfolio of buyer-readable control planes spanning security posture, compliance evidence, data-platform governance, FinOps, and operator workflows. See the suite index for related surfaces. Apex: [kineticgain.com](https://kineticgain.com/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmizcausevic-dev%2Fbigquery-query-cost-watch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmizcausevic-dev%2Fbigquery-query-cost-watch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmizcausevic-dev%2Fbigquery-query-cost-watch/lists"}