49 lines
2.2 KiB
Markdown
49 lines
2.2 KiB
Markdown
---
|
|
domain: platform-common
|
|
last_rule_review_commit: 4695bcbc60322b567a6e76d872490e696df672ed
|
|
last_rule_updated_at: 2026-08-02
|
|
---
|
|
|
|
# Platform Common
|
|
|
|
## Responsibility
|
|
|
|
Platform Common owns stable packages shared by applications: provider execution primitives, configuration, authentication, audit/events, host setup, metadata, observability, policy, stream evidence gating, versioning, and protobuf source/generated Go bindings.
|
|
|
|
## Owned paths
|
|
|
|
- `packages/go/execution/`
|
|
- `packages/go/config/`
|
|
- `packages/go/audit/`
|
|
- `packages/go/auth/`
|
|
- `packages/go/events/`
|
|
- `packages/go/hostsetup/`
|
|
- `packages/go/metadata/`
|
|
- `packages/go/observability/`
|
|
- `packages/go/policy/`
|
|
- `packages/go/streamgate/`
|
|
- `packages/go/version/`
|
|
- `proto/iop/` and `proto/gen/iop/`
|
|
- `configs/`
|
|
|
|
## Required patterns
|
|
|
|
- Common packages must not import application-internal packages.
|
|
- `packages/go/execution` remains transport-neutral and defines provider lifecycle, execution events, typed failures, usage, cancellation, registry, optional commands, and tunnels.
|
|
- Configuration uses named provider adapters and provider resource catalogs. Strict loading rejects removed process-control and automation-ownership keys.
|
|
- External API model ids are translated at the Edge boundary; internal execution uses `adapter + target`.
|
|
- `session_id` is correlation only and cancellation targets `run_id`.
|
|
- Stream-gate runtime remains request-local, bounded, transport-neutral, and free of raw payload persistence.
|
|
- Protobuf changes start in `proto/iop/*.proto`, preserve removed numbers/names as reservations, and regenerate Go and Dart bindings.
|
|
- Tracked configuration and documentation must not contain credentials or private endpoints.
|
|
|
|
## Prohibited ownership
|
|
|
|
Shared runtime packages must not manage interactive terminals, persistent host programs, working-directory execution context, resumable conversations, arbitrary host commands, or local quota scraping.
|
|
|
|
## Contracts and verification
|
|
|
|
- `agent-contract/inner/execution-runtime.md`
|
|
- `agent-contract/inner/edge-config-runtime-refresh.md`
|
|
- `agent-contract/inner/edge-node-runtime-wire.md`
|
|
- Follow the testing domain rule for shared package, config, or protobuf changes.
|