Skip to content

[research] Additional fixes required for proper entity retrieval#4424

Merged
mmabrouk merged 2 commits into
fix/workflows-retrieve-guardrailsfrom
fix/workflow-retrieve-guardrails-extension-2
May 26, 2026
Merged

[research] Additional fixes required for proper entity retrieval#4424
mmabrouk merged 2 commits into
fix/workflows-retrieve-guardrailsfrom
fix/workflow-retrieve-guardrails-extension-2

Conversation

@junaway
Copy link
Copy Markdown
Contributor

@junaway junaway commented May 26, 2026

No description provided.

Copilot AI review requested due to automatic review settings May 26, 2026 11:17
@vercel
Copy link
Copy Markdown

vercel Bot commented May 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agenta-documentation Ready Ready Preview, Comment May 26, 2026 11:27am

Request Review

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 26, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 8a3b8154-60f4-440b-8109-fbad512e4c4b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/workflow-retrieve-guardrails-extension-2

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a design follow-up document that enumerates remaining gaps in retrieve reference resolution (entity-ref vs environment-ref), and outlines a concrete remediation plan (C-items) mapped to current discrepancies (D-items).

Changes:

  • Introduces a structured “five rules” model for retrieve reference resolution and path-mixing behavior.
  • Documents current behavioral discrepancies (D1–D15) and proposed implementation steps (C1–C10), with suggested landing order.
  • Adds doc references to prior audit work and highlights needed test/doc follow-ups.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

### D6. Docs site lies about behavior

PR #4418/#4422 fixed the per-field descriptions on the 6 request models. But
[`02-fetch-prompt-programatically.mdx`](../../docs/prompt-engineering/integrating-prompts/02-fetch-prompt-programatically.mdx)
### D6. Docs site lies about behavior

PR #4418/#4422 fixed the per-field descriptions on the 6 request models. But
[`02-fetch-prompt-programatically.mdx`](../../docs/prompt-engineering/integrating-prompts/02-fetch-prompt-programatically.mdx)

---

## Section 1 — The five rules
environment's deployment map. Evaluators reject path-mixed requests with 400.
Neither is documented as the rule; both are observable behavior.

### 2.a — Unique, minimal, sufficient, consistent

**Expected behavior:** 200, returned revision matches the references.

### 2.b — Unique, redundant, sufficient, consistent
Comment on lines +111 to +115
2.d.

**Expected behavior:** 200. Redundancy is silently fine when it's consistent.

### 2.c — Unique, redundant, sufficient, inconsistent
**Expected behavior:** 400 (or 422) naming the conflicting field. Today, all
inconsistencies in this case are silently absorbed — see D1 and D10.

### 2.d — Unique, minimal, insufficient, consistent
deployment under that key, etc.). All fallback rules must be deterministic
and consistent across entities.

### 2.e — Non-unique or insufficient
@mmabrouk mmabrouk merged commit a4869d7 into fix/workflows-retrieve-guardrails May 26, 2026
4 of 5 checks passed
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