Skip to content

fix(maestro-case): preserve SDD filter literals when FilterBuilder is absent - #2555

Open
song-zhao-25 wants to merge 3 commits into
mainfrom
fix/case-filter-literal-recovery
Open

fix(maestro-case): preserve SDD filter literals when FilterBuilder is absent#2555
song-zhao-25 wants to merge 3 commits into
mainfrom
fix/case-filter-literal-recovery

Conversation

@song-zhao-25

@song-zhao-25 song-zhao-25 commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Issue

The skill equated a missing design-time FilterBuilder with no server-side filtering. When case spec --input-details rejected a structured filter: tree, implementation could drop an SDD-declared filter even when the connector exposed it as a normal request field.

Observed on Outlook 365 ListEmails: the generated case omitted the required subject filter, while the known-good case preserved the native OData literal at queryParameters.filter.

Root cause

spec.filter describes structured designer filter support only. A connector may independently expose a native filter field through inputs.queryParameters[] or inputs.bodyFields[]. These paths use connector-native syntax and must remain in their declared request container.

Changes

  • Planning — treat spec.filter: undefined as no structured filter authoring only. Preserve an SDD literal exactly under the spec-declared query/body sink. If neither a FilterBuilder nor a plain field can represent the requirement, halt before writing tasks.md; never drop it or invent downstream processing.
  • Implementation preflight — inspect a top-level filter: before calling case spec. For a malformed legacy plan, recover only the exact value from the authoritative SDD (or same-session confirmed model), repair the existing T-entry in place, preserve its sink and siblings, then rebuild --input-details. Never translate FilterTree/CEQL into OData or another native dialect.
  • Unsupported/ambiguous recovery — halt for a design decision; non-interactive runs report a blocker. No warning-only fallback remains.
  • Lossless-input hard gate — every planned input must survive in the written task. A remaining no-FilterBuilder top-level filter or missing value is a hard failure.
  • Reference docs — distinguish design-time FilterBuilder support from normal native filter inputs and retain the CLI rejection text as an explicitly overstated message.

Validation

  • quick_validate.py skills/uipath-maestro-case
  • hooks/validate-skill-descriptions.sh
  • git diff --check

The existing CM-Golden semantic check already asserts the exact Outlook ListEmails filter value. The live tenant evaluation was not rerun for this follow-up.

Out of scope

Equivalent wording in other owning skills remains for separate owner review.

@song-zhao-25
song-zhao-25 marked this pull request as ready for review August 11, 2026 02:45
song-zhao-25 and others added 3 commits August 10, 2026 19:50
… absent

No-FilterBuilder was categorically equated with no server-side filtering,
so implementation dropped SDD-declared filter literals that the connector
contract accepts as plain query parameters (runtime-verified: Outlook 365
ListEmails declares queryParameters.filter, "Additional OData filters").

- planning: spec.filter undefined rules out structured CEQL authoring
  only; SDD literals matching declared plain fields stay in input-values
- impl Step 4: ordered recovery on FilterBuilder rejection (declared
  plain field -> native-syntax literal -> downstream filtering last)
- impl Post-Write check 12: lossless-inputs hard gate — planned inputs
  must survive into the written task, halt instead of warn
- scope raw-CEQL anti-pattern to FilterBuilder operations

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@song-zhao-25
song-zhao-25 force-pushed the fix/case-filter-literal-recovery branch from 1aff653 to 604f068 Compare August 11, 2026 02:51
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