eaos-cli 開発と境界

背景と目的

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

構成図

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-cli

import { baselineImages } from '@alneas/eaos-cli/baseline'

export const requiredImages = baselineImages

CLI は開発環境で Bun を使って実行します。実際の接続と資格情報はホストが供給します。データベースの baseline 検証には、対象の方言に応じたローカル Docker と固定 image が必要です。

トレードオフと判断

所有範囲

プラグイン雛形/診断・Lifecycle操作・構成生成と完了記録。業務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 Loopback plugin development with isolated SQLite Data Contracts, persona switching and verified schema-only baseline generation for the architecture additions and their host boundaries.

OCIの標準配置、Pulumi sourceの生成、eaos up/bootstrap/releaseはOCI Presetとリリースを参照してください。

Generate a verified SQLite, PostgreSQL and Oracle baseline.