Skip to content

🍒 [v1.207] docs(uipath-maestro-flow): retire the "check misses a missing output" rule - #4884

Merged
rockymadden merged 1 commit into
release/v1.207from
docs-flow-retire-return-output-rule-CP-to-release-v1-207
Nov 18, 2026
Merged

rockymadden merged 1 commit into
release/v1.207from
docs-flow-retire-return-output-rule-CP-to-release-v1-207

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Short version

check now catches a .return() that leaves a declared output unset, so the skill no longer needs to warn that it does not. SKILL.md drops Critical Rule 5. references/author.md rule 6 now says what check covers and what it still misses.

Why

The SDK added RETURN_OUTPUT_MISSING (error) in UiPath/builder-sdk#2020, shipped in @uipath/maestro-builder-sdk 6.100.0. Example:

flow('R').output({ a: types.string, b: types.string })
  .step('s', script({ code: 'return 1;' }))
  .return({ a: lit('x') })
// check: ✗ [RETURN_OUTPUT_MISSING] The .return() after "s" does not set output "b" ...

The old text was also partly wrong: it said the run returns undefined. It returns null (the End maps the output to null).

What changed

  • skills/uipath-maestro-flow/SKILL.md: Critical Rule 5 ("Bind every declared output on every path. check misses a missing one...") removed. Rules 6-9 become 5-8. Nothing in the repo cites them by number (searched SKILL.md, references, flavors, tests, .claude/). "Authoring a flow" no longer lists "outputs" among what Critical Rules govern.

  • skills/uipath-maestro-flow/references/author.md rule 6 rewritten. Kept, because check still cannot see two cases:

    • an SDK older than 6.100.0 (the Studio Web flavor uses the SDK Studio Web bundles, whose version this repo does not pin);
    • an output set with { updates } on only some paths: a .return() on a path that skipped the update maps it from its backing Variable, so it returns the default or null, and check does not flag it.

    It also tells the agent to write lit(null) when null is the intended answer. author.md rule numbers are unchanged.

  • No Studio Web flavor override touches either passage.

Checks

  • node scripts/check-skill-links.mjs: all links and anchors resolve.
  • npm run skills:validate: OK (default and studioweb, 31 skills each).
  • pytest tests/tasks/uipath-maestro-flow/_shared: 1882 passed (includes the SKILL.md size budget, the 240-line read window and the brownfield turn-rule pins).
  • node --test tests/scripts/studioweb-flavor-contract.test.mjs tests/scripts/check-skill-links.test.mjs: 48 passed.
  • Not run: coder-eval tasks.

🤖 Generated with Claude Code
Co-Authored-By: Claude


Automatically cherry-picked from #4734 to release/v1.207 by @rockymadden.

… rule (#4734)

Short version: check now reports a .return() that leaves a declared
output unset (RETURN_OUTPUT_MISSING, @uipath/maestro-builder-sdk 6.100.0,
UiPath/builder-sdk#2020). So SKILL.md drops Critical Rule 5, and author.md
rule 6 says what check covers, what it still misses (an output set with
{ updates } on only some paths, and any SDK older than 6.100.0), and what
to do about it.

🤖 Generated with Claude Code
Co-Authored-By: [Claude](mailto:noreply@anthropic.com)

@roberts-cliff roberts-cliff left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Clean pick of #4734: the diff has the same patch-id as #4734, which is merged on main. Only the Socket and WIP checks ran on this bot-made PR.

@roberts-cliff roberts-cliff left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cherry-pick reviewed — diff matches source. LGTM.

@rockymadden
rockymadden merged commit 13bc3d1 into release/v1.207 Nov 18, 2026
8 checks passed
@rockymadden
rockymadden deleted the docs-flow-retire-return-output-rule-CP-to-release-v1-207 branch November 18, 2026 14:50
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.

4 participants