docs: refine operation interfaces and batching

draft/unresolved-issues.md

@@ -6,29 +6,31 @@
 
 対象: [2.1. Object tree / Schema](../2.1-object-tree-schema.md)
 
-- Object / エントリ公開情報の具体的なwire schema。
+- Object / エントリ公開情報とInterface参照の具体的なwire schema。
 - `name`とpath segmentの関係。
 - entry pathのcanonicalization規則。
-- `description`の長さや必須性をprotocol上でどこまで規定するか。
+- Object `description`の長さや必須性をprotocol上でどこまで規定するか。
 
 ## 2.2. Operation / WIP IDL
 
 対象: [2.2. Operation](../2.2-operation.md)、[WIP IDL](wip-idl.md)
 
-- WIP IDL sourceのcanonicalization、digest algorithm、参照方法。
+- WIP IDL sourceのcanonicalization、digest algorithm、Interface参照の形式とscope。
 - WIP IDLのversion間における互換性規則。
-- Sourceにdescriptionやdocumentation commentを含めるか。
 - String length、numeric range、pattern等のconstraintを導入するか。
 - Recursive named typeを許可するか。
 - `i64`、`u64`、`bigint`、`decimal`等を追加するか。
-- `description`の必須性と長さ。
-- error型をOperation outputに含めるか、Protocol errorとして分離するか。
+- Operation documentationの必須性と長さ。
+- Effect annotationを採用するか、および構文と標準effectの集合。
+- `fail<E>`を採用する場合のdomain failure表現。
+- domain errorをOperationのreturn typeに含めるか、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`で観測整合性情報をどう共有するか。
+- `fetch_interface`のrequest / response wire schema。
+- Effect annotationを採用した場合に、副作用のない`call_operation`をbatch対象へ加えるか。
+- Batch件数、request / response byte size、timeoutの上限。
+- Batch envelope自体が不正な場合のHTTP statusとerror body。
+- Subrequest共通のProtocol error schema。