Skip to content

feat(examples/playground): add 7 trust-arc POCs for engine v1.11.0#196

Merged
hugocorreia90 merged 1 commit intomainfrom
feat/trust-arc-pocs
Apr 21, 2026
Merged

feat(examples/playground): add 7 trust-arc POCs for engine v1.11.0#196
hugocorreia90 merged 1 commit intomainfrom
feat/trust-arc-pocs

Conversation

@hugocorreia90
Copy link
Copy Markdown
Contributor

Summary

Ships one runnable POC per trust arc, matching the engine v1.11.0 surface. Gives the public launch a concrete, single-`./run.sh` demo for each of the seven arcs.

  • Arc 1 — Branches + replay + lineage → `pocs/00-foundations/06-branches-replay-lineage`
  • Arc 2 — Cost summary + [budget] → `pocs/02-performance/10-cost-budgets`
  • Arc 3 — Circuit breaker + retry → `pocs/05-orchestration/08-circuit-breaker` (config surface; DuckDB has no transient-error path, so the POC points at Databricks/Snowflake to observe the breaker fire)
  • Arc 4 — `rocky trace` Gantt → `pocs/06-developer-experience/07-run-trace-gantt`
  • Arc 5 — Schema-grounded AI → `pocs/03-ai/05-schema-grounded-validation` (`ANTHROPIC_API_KEY` gated, aligned with rest of 03-ai/)
  • Arc 6 — Portability lint P001 → `pocs/06-developer-experience/08-portability-lint`
  • Arc 7 — SQL types + blast-radius → `pocs/06-developer-experience/09-sql-types-blast-radius`

Catalog counts updated to 53 POCs / 40 credential-free in both `examples/playground/README.md` and `examples/playground/pocs/README.md`.

Known gaps — called out in each POC's README, not papered over:

  • Arc 1: `rocky replay` is inspection-only today; the run-record write path arrives in Arc 1 wave 2 with the content-addressed storage primitive. The POC runs `rocky replay latest` and captures the "no runs recorded yet" shape.
  • Arc 3: DuckDB can't exercise the three-state breaker (no transient-error surface). The POC validates the full `[adapter.retry]` config shape and points at the adapters where the breaker actually fires.

Test plan

  • `./scripts/run-all-duckdb.sh` — all 6 credential-free new POCs pass; Arc 5 correctly skipped (credentials gated)
  • Arc 1 — verifies branch isolation in the warehouse (`staging__orders.orders` vs `branch__fix_revenue.orders`)
  • Arc 2 — emits a `budget_breaches` entry with `limit_type`/`limit`/`actual`
  • Arc 3 — `rocky validate` confirms the retry config parses
  • Arc 4 — two concurrent runs recorded; `rocky trace latest` inspected
  • Arc 6 — P001 diagnostic fires on NVL under `--target-dialect bq`; pragma + project-wide allowlist both suppress
  • Arc 7 — `--with-seed` lifts incrementality-hint confidence from medium→high; `SELECT *` I001 diagnostic fires with byte-span

🤖 Generated with Claude Code

Ship one runnable POC per trust arc, matching engine v1.11.0's
shipped-and-default surface. All credential-free POCs pass
`./scripts/run-all-duckdb.sh`; the Arc 5 POC is gated on
`ANTHROPIC_API_KEY` in line with the rest of `03-ai/`.

- 00-foundations/06-branches-replay-lineage — Arc 1: `rocky branch`,
  `rocky run --branch`, `rocky replay` (inspection-only today), and
  `rocky lineage --downstream` on a 3-model DAG.
- 02-performance/10-cost-budgets — Arc 2: per-run `cost_summary` +
  `[budget]` block with intentionally tiny `max_duration_ms` so the
  demo always produces a `budget_breaches` entry.
- 05-orchestration/08-circuit-breaker — Arc 3: validates the full
  `[adapter.retry]` surface (threshold, recovery timeout, backoff),
  prints the three-state diagram, and points at the Databricks /
  Snowflake adapters where the breaker actually fires.
- 06-developer-experience/07-run-trace-gantt — Arc 4: `rocky trace
  latest` read-path demo with two concurrent runs seeded into the
  state store; ties the Gantt to the feature-gated OTLP exporter.
- 03-ai/05-schema-grounded-validation — Arc 5: `rocky ai` with
  `ValidationContext` + compile-verify retry loop. Seeded models give
  the LLM a typed schema to ground against.
- 06-developer-experience/08-portability-lint — Arc 6: `rocky compile
  --target-dialect bq` fires P001 on NVL, suppressed per-file via
  `-- rocky-allow: NVL` and project-wide via `[portability] allow`.
- 06-developer-experience/09-sql-types-blast-radius — Arc 7: `rocky
  compile --with-seed` grounds raw `.sql` column types from an
  in-memory DuckDB's `information_schema`, lifting incrementality-
  hint confidence from medium→high; semantic-graph-aware `SELECT *`
  lint fires with byte-span diagnostics.

Catalog updates in examples/playground/{README.md,pocs/README.md} to
53 POCs (40 credential-free).
@hugocorreia90 hugocorreia90 merged commit 950ad63 into main Apr 21, 2026
7 checks passed
@hugocorreia90 hugocorreia90 deleted the feat/trust-arc-pocs branch April 21, 2026 10:02
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