Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Document multi-value claims with rowBoundaries operator:in (and their per-record application)

クローズ 初心者向け
  • 何か問題がありますか？
#2,431 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
70/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
markdown, rust, yaml
領域
documentation

調査の方向性

最初に crates/registry-breg/src/api/mod.rs (~2849) と authority.rs (~190) を読み、In の複数値処理を確認し、次に auth.rs と context.rs でレコードごとの AND (per-record AND) を確認する。authoring ドキュメント (例: docs/) を探し、operator: in を用いた複数値クレーム、fail-closed 動作、および bregctl explain access への言及に関するセクションを追加する。Done は、ドキュメントが dev-clients の構文と silent failure modes を明確にカバーしていることを意味する。

索引モデルが issue の本文から書いたものです。

説明

documentation

Summary

rowBoundaries supports operator: in with multi-value claims, and the boundary applies independently to every referenced record of that type. This is the only way we found to model a caller authorized over several records of the same type in one action (e.g. a representative filing a merger over two companies), but it does not appear to be documented anywhere we looked, and the failure modes are silent.

Proven behaviour (live, origin/main 634eba0b2)

dev-clients.yaml accepts an array claim:

claims:
  registry_represented_brns: [SAMPLE-LR-A, SAMPLE-LR-B]

and a target boundary:

targets:
  - recordType: company
    rowBoundaries: [{field: brn, claim: registry_represented_brns, operator: in}]
  • an action with two company reference inputs is authorized only when both referenced records match the claim set → a caller holding only [SAMPLE-LR-A] is refused at proposal start when the second company is SAMPLE-LR-B (exactly the "one-company representation is insufficient" authority check our benchmark needed)
  • a missing claim fails closed (row-claim-missing-or-wrong-cardinality / concealed)
  • equals + an array claim is denied; only in accepts multi-value
  • one dev client per access profile may be claim-free (the "default"); a second client with different claims needs explicit testBindings or dev session start refuses with "a shared local access profile needs at most one default client"

Source pointers

  • crates/registry-breg/src/api/mod.rs verified_row_boundaries_from_sources (~2849) — Equals requires exactly one claim value; In carries all values
  • crates/registry-breg/src/authority.rs ~190 — multi_value set for BoundaryOperator::In
  • crates/registry-breg/src/auth.rs map_authority_claim (~799) — array claims mapped per entry
  • crates/registry-breg/src/postgres/context.rs snapshot_matches_boundaries (~1243) — per-record AND semantics

Ask

Document multi-value claims + operator: in (dev-clients syntax, per-record application, fail-closed behaviour) in the authoring docs; a bregctl explain access mention would also help. If per-record application is not intended semantics for multi-reference actions, that is worth stating explicitly too.

主要言語
Rust
スター
2
フォーク
0
平均マージ
7時間 52分
マージ済み PR（30日）
264

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

registrystack/registry-stack のほかの issue

registrystack/registry-stack の issue をすべて見る

似ている issue

Rust の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。