code change · featureAL Developmentofficial - Microsoftreviewed - checked by Opus

#179 Add bounded knowledge retrieval

Adds bounded, lossless knowledge retrieval for BCQuality review skills. Catalog pages are capped at 16,000 UTF-8 bytes and return every applicable row with no ranking. Article and sample bodies are fetched exactly in chunks of up to eight paths. Each review leaf gets private GUID-scoped scratch and report paths, and its return is validated deterministically before rollup.

Pull request · merged into main on 2026-09-11 by JesperSchulz · 26 files (+1892 -56), 19 AL · feature · tier official · reviewed (checked by Opus)

What changed

  • Lossless catalog paging capped at 16,000 serialized UTF-8 bytes, with no ranking, top-k filtering or query-based omission
  • Exact article and sample bodies returned in chunks of up to eight paths with byte count, SHA-256, strict UTF-8 and path-safety checks
  • Continuations are tied to the prepared index and request state; the v2 catalog format makes applicability explicit
  • Each review leaf gets GUID-scoped scratch and report paths, and its Task return is validated deterministically before rollup
  • The bounded Source workflow now applies to all 16 Microsoft review skills; their Relevance, Worklist, Action and Output rules are unchanged
  • Behaviour changes for users or extensions.

AL objects touched

  • microsoft/skills/review/al-appsource-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-breaking-changes-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-code-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-data-modeling-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-error-handling-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-events-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-interfaces-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-performance-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-privacy-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-query-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-security-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-style-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-telemetry-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-testing-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-ui-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-upgrade-review.md: modified, not in the BC? snapshot
  • microsoft/skills/review/al-web-services-review.md: modified, not in the BC? snapshot
  • skills/do.md: modified, not in the BC? snapshot
  • skills/read.md: modified, not in the BC? snapshot

Context

  • Systems: development
  • From the description: “Add lossless deterministic catalog paging capped at 16,000 serialized UTF-8 bytes, including the output newline.”

Source: metadata of a merged pull request in microsoft/BCQuality (bcquality): title, labels, changed paths and counts, with a summary in our words. No source text and no description beyond one short quote (D10, D61).