init

draft/unresolved-issues.md

@@ -0,0 +1,24 @@
+# 未解決事項
+
+各設計ページに未解決事項を分散させず、このページで対象ページとともに一元管理する。
+
+## 2.1. Object tree / Schema
+
+対象: [2.1. Object tree / Schema](../2.1-object-tree-schema.md)
+
+- Object / エントリ公開情報の具体的なwire schema。
+- `name`とpath segmentの関係。
+- `description`の長さや必須性をprotocol上でどこまで規定するか。
+- Linkの標準表現。
+- Operation Result内でエントリ / エントリツリー / Linkをどう統一的に表現するか。
+
+## 2.2. Operation
+
+対象: [2.2. Operation](../2.2-operation.md)
+
+- input / outputに使う型システム。
+- `description`の必須性と長さ。
+- optional / union / enum / record等の表現。
+- Object / Linkを値として返す場合の標準表現。
+- Guardの具体的schema。
+- error型をOperation outputに含めるか、Protocol errorとして分離するか。

draft/wip-over-https.md

@@ -0,0 +1,29 @@
+# WIP over HTTPS
+
+WIP over HTTPSは、**WIP Core ProtocolをHTTPS上へ対応付ける標準Transport Binding**である。
+
+## 目的
+
+Core Protocolの意味論を変えずに、既存のWebインフラを利用してClientとHostを接続する。
+
+## 方針
+
+標準bindingとしてHTTPSを採用することを第一候補とする。
+
+HTTPSを利用することで、TLS、認証、Proxy、Gateway、Observability、Caching、Streamingなど既存の仕組みを再利用できる。
+
+必要に応じてHTTP/2、HTTP/3、SSE、WebSocket等を利用してよい。ただし、これらは通信上の最適化または補助機構であり、WIP Core Protocolの意味論を変更しない。
+
+## Binding対象
+
+少なくとも、Core Protocolの以下の操作をHTTP request / responseへ対応付ける。
+
+- `fetch`
+- `fetch_tree`
+- `call_operation`
+
+具体的なHTTP method、endpoint、content type、error mapping、認証方式、streaming表現などは、このbinding仕様側で定義する。
+
+## 非目標
+
+WIP over HTTPSはHost内部のAPIやデータソース接続方式を規定しない。また、WIP Core ProtocolそのものをHTTP依存のモデルへ変えることも目的としない。