eaos-storage 開発と境界

背景と目的

公開契約とホストの実行責任を分け、同じ機能の重複や権限の取り違えを防ぎます。

構成図

flowchart LR
  Host[Trusted host] --> Adapter[Scoped Server adapter]
  Adapter --> Store[Host-owned durable provider]

Public import

パッケージを導入し、以下の完全なサブパスから利用します。サブパスは別パッケージではありません。EAOS の公開前は、ワークスペースで生成してチェックサムを検証した配布物を使います。

bun add @alneas/eaos-server

import { createTenantStorage } from '@alneas/eaos-server/storage'

export function bindStorage(...args: Parameters<typeof createTenantStorage>) {
  return createTenantStorage(...args)
}

サーバー専用です。外部ストレージ adapter、検証済みの組織・プラグインのスコープ、現在の認可を供給します。プロバイダーの資格情報はサーバー側で管理してください。

トレードオフと判断

所有範囲

tenant-scoped storage・認可と署名URLの境界。業務plugin・業務物理schema・顧客データ・秘密値・実環境設定・運用receiptは含めません。

開発

EAOS依存がまだ未公開の場合は、workspaceのビルド入口を使います。先行パッケージをtgzにして隔離環境へ導入し、型生成・テスト・packの成功後だけ最新receiptを更新します。

認可・永続化

tenant/user/rolesは検証済みホストから渡します。Lifecycleの有効状態とresource権限を実行時に再確認します。CASは古いrevisionを拒否し、監査/Outboxはホストがdurableなstoreへ保存します。SQL接続・provider資格情報はホストから注入します。

配布と適用

コードの導入、DB/infra適用、tenant有効化は別操作です。build/test/installは本番migrationやPulumi updateを実行しません。共通ドキュメントサイトの原稿はこのrepoのdocsが正本です。