docs(skill): sync CEL function tables to 9.8.0 stdlib + drift-guard#1967
Merged
Conversation
The authoring skills under-listed the stdlib (6 functions + "only the above"), omitting the 14 registered in 9.8.0 (daysBetween/abs/round/min/max/upper/lower/ contains/startsWith/endsWith/matches/len/isEmpty/date/datetime) — so AI authors never used daysBetween and kept hand-rolling workarounds. - Rewrite objectstack-formula stdlib table (grouped + CEL built-ins); fix the daysFromNow/daysAgo note (keep wall-clock time, not midnight). - Rewrite objectstack-automation "time-relative rule" anti-pattern to the precise one-day window pattern ($gte daysFromNow(N) / $lt daysFromNow(N+1) + $or); add daysBetween for days-remaining. - Add a drift-guard test (packages/formula) pinning skill ↔ CEL_STDLIB_FUNCTIONS. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
github-actions
Bot
added
documentation
Contributor
📓 Docs Drift CheckThis PR changes 1 package(s): 5 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:
|
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
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.
Platform follow-up to #1949 — closes the last surface of the catalog/runtime alignment: the AI-facing skill.
Problem
The authoring skills (objectstack-formula / -automation) are what an AI author reads to know which CEL functions exist. They listed ~6 functions and capped with "only the stdlib above", omitting the 14 registered in 9.8.0 (
daysBetween,abs,round,min,max,upper,lower,contains,startsWith,endsWith,matches,len,isEmpty,date/datetime). So the AI never reached fordaysBetween(days-remaining) and kept hand-rolling.Changes
daysFromNow/daysAgonote — they keep the wall-clock time, not midnight (the doc previously saidtoday()+n*24h).$gte daysFromNow(N)/$lt daysFromNow(N+1)+$or) instead of the impreciseBETWEEN TODAY and TODAY+N; note the date-equality filter footgun (build warnsflow-date-equality-filter); adddaysBetweenfor days-remaining.@objectstack/formulaasserts everyCEL_STDLIB_FUNCTIONSentry is documented in the skill, so the AI-facing list can't fall behind the runtime catalog again (mirrors the runtime drift-guard in feat(formula): align CEL stdlib catalog with runtime (#1928) #1949).check:skill-docsgreen; drift-guard 1/1.🤖 Generated with Claude Code