eaos-core 開発と境界

背景と目的

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

構成図

flowchart LR
  Contract[Public contract] --> Host[Verified host bindings]
  Host --> Runtime[Scoped runtime operation]
  Runtime --> Evidence[Durable result and audit]

Public import

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

bun add @alneas/eaos-core

import { definePlugin } from '@alneas/eaos-core'

export const defineFeature = definePlugin

Core は Server 実装に依存しない契約・純粋なヘルパーを提供します。認証済みのスコープ、現在の認可、DB・ストレージ接続はホスト側で供給してください。

トレードオフと判断

所有範囲

Plugin SDK・認可境界・監査/Outbox・共通契約。業務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が正本です。

See Declarative plugin SDK, pure commercial contracts and an injectable test harness for the architecture additions and their host boundaries.