agnes-the-ai-analyst/docs/superpowers/specs
ZdenekSrotyr 4aa96f2546 docs(specs): #160 implementation spec for da query --remote VIEW fix
Spec for the upcoming fix: when query_mode='remote' BigQuery rows have a
VIEW or MATERIALIZED_VIEW entity, da query --remote currently fails with
DuckDB catalog error because the extractor (with legacy_wrap_views=False
default) skips master view creation for those entity types.

Plan:
- always create master view (Storage Read API for BASE TABLE; jobs API
  via bigquery_query() for VIEW/MATERIALIZED_VIEW); remove the
  legacy_wrap_views config knob entirely
- add server-side cost guardrail on /api/query (5 GiB default cap,
  per-user daily-byte + concurrent-slot quota shared with /api/v2/scan)
- close pre-existing RBAC hole on direct bq."ds"."tbl" references
  (registry-gated; admin must register first)
- add bigquery_query() to SQL blocklist (closes function-call backdoor)
- shared CLI structured-error renderer (cli/error_render.py) so typed
  BqAccessError details render readably instead of raw JSON dumps
- /admin/server-config: BQ "Test connection" button + placeholder for
  billing_project showing the resolved fallback to data project

TDD plan in 6 phases / 11 commits — see spec section 6.
2026-05-04 10:31:35 +02:00
..
2026-03-27-refactoring-design.md docs,tests: anonymize customer references 2026-04-21 11:56:19 +02:00
2026-03-30-core-refactoring-design.md feat: implement extract.duckdb contract — orchestrator + extractors 2026-03-30 20:12:56 +02:00
2026-03-31-data-access-control.md feat: implement data access control — table-level permissions 2026-03-31 12:33:31 +02:00
2026-04-09-multi-instance-deployment-design.md feat(tls): corporate-CA HTTPS with URL-driven rotation, on-VM CSR gen, self-signed fallback (#51) 2026-04-25 19:51:25 +00:00
2026-04-10-porting-internal-features-design.md docs: fix design spec after code review 2026-04-10 18:58:39 +02:00
2026-04-11-remote-query-design.md docs: fix remote query spec after code review 2026-04-11 10:58:25 +02:00
2026-04-12-comprehensive-test-strategy-design.md docs: add comprehensive test strategy spec (6 parallel blocks, 4 layers) 2026-04-12 10:33:26 +02:00
2026-04-14-connector-kit-design.md User management + PAT + CLI distribution + HTML auth redirect (#9 #10 #11 #12) (#28) 2026-04-22 14:24:28 +02:00
2026-04-21-multi-customer-deployment-spec.md chore(oss): isolate customer-specific deploy bits from scripts/grpn/ (#88, wave 1) (#94) 2026-04-27 20:24:34 +02:00
2026-04-27-claude-fetch-primitives-design.md feat(v2): claude-driven fetch primitives + 0.14.0 (#102) 2026-04-29 01:07:19 +02:00
2026-04-29-dev-debug-toolbar-design.md feat(observability): request_id end-to-end + dev debug toolbar + centralized logging (#136) 2026-04-29 22:54:21 +02:00
2026-04-29-issue-134-bq-access-unify-design.md fix(v2): #134 BigQuery cross-project errors return structured 502/400 + BqAccess facade (#138) 2026-04-30 10:11:20 +02:00
2026-05-03-issue-160-da-query-remote-fix-spec.md docs(specs): #160 implementation spec for da query --remote VIEW fix 2026-05-04 10:31:35 +02:00