docs: define operation IDL and entry discovery

This commit is contained in:
2026-09-08 12:11:52 +09:00
parent 138fda8ea6
commit 1520852238
9 changed files with 435 additions and 45 deletions
+19 -8
View File
@@ -8,17 +8,28 @@
- Object / エントリ公開情報の具体的なwire schema。
- `name`とpath segmentの関係。
- entry pathのcanonicalization規則。
- `description`の長さや必須性をprotocol上でどこまで規定するか。
- Linkの標準表現。
- Operation Result内でエントリ / エントリツリー / Linkをどう統一的に表現するか。
## 2.2. Operation
## 2.2. Operation / WIP IDL
対象: [2.2. Operation](../2.2-operation.md)
対象: [2.2. Operation](../2.2-operation.md)、[WIP IDL](wip-idl.md)
- input / outputに使う型システム
- WIP IDL sourceのcanonicalization、digest algorithm、参照方法
- WIP IDLのversion間における互換性規則。
- Sourceにdescriptionやdocumentation commentを含めるか。
- String length、numeric range、pattern等のconstraintを導入するか。
- Recursive named typeを許可するか。
- `i64``u64``bigint``decimal`等を追加するか。
- `description`の必須性と長さ。
- optional / union / enum / record等の表現。
- Object / Linkを値として返す場合の標準表現。
- Guardの具体的schema。
- error型をOperation outputに含めるか、Protocol errorとして分離するか。
- error型をOperation outputに含めるか、Protocol errorとして分離するか。
## WIP over HTTPS
対象: [WIP over HTTPS](wip-over-https.md)
- 複数の`fetch`をまとめるbatch request / responseのwire schema。
- Invoke時に`included`を要求する方法と、Hostが自動同梱できる条件。
- `included`のresponse size上限とtruncation表現。
- `included`と個別の`fetch`で観測整合性情報をどう共有するか。