docs(playground): runnable POCs for the 1.52.0 feature wave#935
Merged
Conversation
…g-emit Six new credential-free DuckDB POCs demonstrating the engine 1.52.0 wave, each with a run.sh validated end-to-end against the 1.52.0 binary: - 00-foundations/13-surrogate-keys — [[surrogate_key]] injects a dbt_utils-identical MD5 hash column at run - 00-foundations/14-config-groups — models/groups/*.toml fan-out + enforce/misplacement load guards (broken/ siblings) - 01-quality/09-named-tests — test_definitions.toml + [[use_test]] with column/severity overrides - 01-quality/10-unit-tests — fixture-driven [[test]] given/expect run by rocky test - 04-governance/09-model-tags-inheritance — config-group [tags] baseline + per-key sidecar override - 06-developer-experience/21-emit-sql-exit-path — rocky emit-sql then run the SQL through DuckDB, no Rocky Also extends 06-developer-experience/12-catalog-emit with a [columns.<name>] description on a projected column, surfaced in rocky catalog --output json. poc-counts cascade applied (README counts + catalog rows; 94 total / 82 credential-free).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PR 3 (final) of the docs/POC sweep (after #930 reference docs, #934 discovery docs). The audit found no runnable POC natively authored any of the 1.52.0 features — this adds them.
Six new credential-free DuckDB POCs
Each has a
run.shI re-ran end-to-end against the built 1.52.0 binary (EXIT 0), and each was independently verified to genuinely exercise its feature (not a vacuous pass):00-foundations/13-surrogate-keys[[surrogate_key]]dbt_utils.generate_surrogate_key(recomputed over the full table, incl. the NULL-sentinel path)00-foundations/14-config-groupsschema_template+strategy+tags to 3 members → 3 distinct schemas;broken/siblings prove theenforceand pinned-schema+[args]load guards (with negation tests)01-quality/09-named-tests[[use_test]]test_definitions.tomlapplied across models with column/severity overrides, alongside inline[[tests]]01-quality/10-unit-tests[[test]]given→expectunit tests;unit_testssummary reports all passing (multiset +ordered)04-governance/09-model-tags-inheritance[tags][tags]; visible inrocky compile --output json06-developer-experience/21-emit-sql-exit-pathrocky emit-sql.sql, then runs it through DuckDB with no Rocky — the no-lock-in exit pathPlus
06-developer-experience/12-catalog-emitextended with a[columns.<name>]description on a projected column, surfaced asCatalogColumn.descriptioninrocky catalog --output json.Cascade + hygiene
scripts/update-poc-counts.shrun: README catalog rows added + counts updated (94 total / 82 credential-free), idempotent — satisfiespoc-counts-drift.yml.set -euo pipefail(the config-groups one usesset -uo pipefaildeliberately, matching the broken-sibling precedent), barerocky, credential-free, state cleaned.poc.duckdb/*.redb/.rocky//expected/are gitignored). GOLD/proprietary grep clean.Docs-only/examples PR — like #930/#934 it'll sit BLOCKED on engine checks that never run; merge with
gh pr merge --squash --admin.🤖 Generated with Claude Code