From d003d93181cb03bbd86b70af601376faa703ab2a Mon Sep 17 00:00:00 2001 From: Carlos Montoya Date: Fri, 22 May 2026 17:03:25 -0500 Subject: [PATCH] docs: add animated validate-query-context demo to README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds an SMIL-animated SVG that mirrors the live demo running on the Metatate marketing site (/snowflake, Cortex Code section). 12s loop showing a developer building a churn-model training set and getting back a NOT COMPLIANT verdict from /metatate:validate-query-context, with a suggested rewrite using the PII-stripped feature view. - docs/demo.svg: self-contained SVG using tags for opacity reveal of each beat (comment → command → SQL → thinking pill → verdict → blocking finding → warnings → suggested rewrite). No external assets, no JS, renders inline on GitHub. - README "See It In Action" section added between the intro and "What You Get" with the SVG and a link to the live interactive version on getmetatate.com/snowflake. - demo.svg listed in the Repository Layout block. Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 14 ++++++ docs/demo.svg | 117 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 131 insertions(+) create mode 100644 docs/demo.svg diff --git a/README.md b/README.md index 533cd8c..e90a934 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,19 @@ authorization decisions, explanations, and audit evidence. This plugin does not run a Metatate-hosted MCP gateway and it does not store Snowflake credentials in the plugin repository. +## See It In Action + +A developer is about to pull customer features for a churn model. The plugin +catches the AI governance restriction on the source table, surfaces the +sensitive columns, and suggests a safer rewrite against the PII-stripped +feature view — before the query ever runs. + +![Cortex Code calling metatate:validate-query-context — verdict NOT COMPLIANT, suggested rewrite returned](docs/demo.svg) + +Try the live, interactive version at +[getmetatate.com/snowflake](https://www.getmetatate.com/snowflake) (Cortex Code +plugin section). + ## What You Get - Cortex Code slash commands for governed data workflows: discover governed @@ -45,6 +58,7 @@ metatate-cortex-code-plugin/ cortex-code-install.md snowflake-admin-setup.md troubleshooting.md + demo.svg examples/ prompts.md scripts/ diff --git a/docs/demo.svg b/docs/demo.svg new file mode 100644 index 0000000..8fd26b2 --- /dev/null +++ b/docs/demo.svg @@ -0,0 +1,117 @@ + + Cortex Code · Metatate validate-query-context demo + An animated terminal session showing the Metatate plugin for Cortex Code validating a SQL query for an AI/ML training run. The verdict comes back NOT COMPLIANT due to an AI governance restriction, and Metatate suggests a safer rewrite using a PII-stripped feature view. + + + + + + + + + + cortex code + + + + + + LIVE + + + + + # Building the churn model training set + + + + + + > /metatate:validate-query-context + + + + + + SELECT customer_id, account_email, lifetime_value, + + + + + + plan_tier, churn_score, last_active_at + + + + + + FROM prod.analytics.customer_360 + + + + + + WHERE plan_tier IN ('enterprise', 'business') + + + + + + + + + + + + + + + + validating against decision layer + + + + + + → NOT COMPLIANT ✗ + → validation_id: 6b001c41 + + + + + + + + + + + BLOCKING · AI_GOVERNANCE_RESTRICTED + + prod.analytics.customer_360 is restricted for AI/ML pipelines. + Authorization required before training-set use. + + + + + + WARNINGS · 4 findings + SELECT_STAR_PII · account_email, customer_id + FINANCIAL_SENSITIVITY · lifetime_value + + + + + + + + + + + SUGGESTED REWRITE + + SELECT customer_hash, plan_tier, lifetime_value, + churn_score, last_active_at + FROM prod.analytics.customer_360_ml_features + WHERE plan_tier IN ('enterprise', 'business') + +