Skip to content

docs(cas): update leftValue.name validation guidance - #209

Open
gonzalezw wants to merge 1 commit into
mainfrom
docs/cas-skill-leftvalue-validation
Open

docs(cas): update leftValue.name validation guidance#209
gonzalezw wants to merge 1 commit into
mainfrom
docs/cas-skill-leftvalue-validation

Conversation

@gonzalezw

Copy link
Copy Markdown
Contributor

Summary

A recent tdx release added client-side validation for a composable segment rule's leftValue.nametdx cas sg push and tdx cas validate now catch a mismatch (e.g. using the raw CDW column name instead of the audience's declared attribute name) before it reaches the backend, instead of silently pushing a segment that matches zero rows.

This skill still described the old no-validation behavior as current/permanent in several places, which would give an AI agent (or human) an actively wrong mental model — e.g. telling someone "there's no way to catch this" when the CLI now does.

Changes

  • known-limitations frontmatter: updated to describe the new structural + leftValue.name validation, and the scope limit (unrecognized condition types still pass through by design).
  • The leftValue.name explanation: now describes when the check runs (push always resolves the live audience; offline validate only when a sibling audience.yml is present) and the remaining gap (a lone segment file with no sibling audience YAML).
  • The "no schema validation ahead of push" paragraph: corrected to describe what's now checked vs. what's deliberately left unvalidated.
  • Troubleshooting table: split the old "blank rule / 0 rows" row into the now-caught case (clear error) and the remaining uncaught case (lone file, no sibling audience), plus updated the "unfamiliar low-level error" row.
  • Bumped last-validated.

Test plan

  • Read through the full file for any other stale references to the old behavior — none found.
tdx cas sg push / tdx cas validate now catch a leftValue.name mismatch
before it reaches the backend, instead of silently pushing a segment
that matches zero rows. This skill still described the old no-validation
behavior as current/permanent. Updated the known-limitations, the
leftValue.name section, the schema-validation note, and the
troubleshooting table to match.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@gonzalezw
gonzalezw requested review from a team as code owners August 26, 2026 00:03
@github-actions github-actions Bot added the tdx:core-skills Touches core skills: tdx-skills, sql-skills, workflow-skills label Aug 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tdx:core-skills Touches core skills: tdx-skills, sql-skills, workflow-skills

1 participant