docs: simplify WIP interaction model

This commit is contained in:
2026-09-09 00:25:36 +09:00
parent 1520852238
commit b42b4150e5
8 changed files with 27 additions and 32 deletions
+2 -9
View File
@@ -12,7 +12,6 @@ Operationは少なくとも次の情報を持つ。
- `description` — 何を行う操作かを説明する短い自然言語。
- `input` — 呼び出し時に受け取る入力の型。
- `output` — 呼び出し結果の型。
- `guard` — 必要に応じて公開される実行条件・precondition。
Operation名や型だけに意味を担わせず、`description`をinterface metadataの一部として扱う。長文documentationを埋め込むことは想定しない。
@@ -36,15 +35,9 @@ Operationの可視性は、頻繁に変化する実行可否やdomain stateを
例えばread-only主体には読み取り系Operationのみを公開し、maintainerやadminには追加の更新・管理Operationを公開できる。
WIPはOperationの`available` / `disabled`のような揮発的状態をinterface metadataとして同期することを前提としない。現在の実行可否やpreconditionは、必要に応じてdomain固有のOperationで観測し、最終的なauthorization実行条件は`call_operation`時にHostが検証する
WIPはOperationの`available` / `disabled`のような揮発的状態をinterface metadataとして同期することを前提としない。現在状態を判断する必要がある場合は、必要に応じてdomain固有のOperationで観測する。最終的なauthorization実行条件の判定`call_operation`時にHostが行う
## 2.2.5 Guard
Guardを設ける場合は、現在時点のavailabilityを同期する仕組みではなく、Operationに一般的に課されるpreconditionやconstraintを説明するsemantic metadataとして扱う。
Guardの具体的schemaは未解決事項として管理する。
## 2.2.6 Operation Result
## 2.2.5 Operation Result
Operationの結果には、通常のdomain valueに加えて、WIP IDLの`entry`型として新しいエントリのpathが含まれ得る。