portable specification

Specification
仕様

A map of Takoform's four public contracts: exact Form/Package data, desired Resource lifecycle, read-only Interface projection, and trust/version/release identity.
exact Form/Package、Resource lifecycle、read-only Interface、 trust/version/releaseという4つの公開contractへの入口です。

Canonical specification Provider docs

Not GA / GAではありません

The API group is forms.takoform.com/v1alpha1.
Breaking protocol changes remain possible.
All 34 current Form Packages are published and immutable.
Exactly 10 are admitted under forms/admissions/v1.0.6.
Provider v1.0.1 does not make the API stable.

Four contracts, separate authorities

The specification fixes portable identities and lifecycle semantics. It does not prescribe a Cloud, backend, scheduler, credential system, price, or operator policy.

AUTHOR

Form and package

A Form Definition describes desired state. A data-only Form Package binds exact canonical bytes and evidence to that versioned identity.

HOST

Admission and realization

A host advertises exact availability, admits packages, realizes Resources, selects concrete backends, and owns authorization.

CLIENT

Provider lifecycle

The typed provider discovers the host and drives preview, apply, read, observe, refresh, import, and delete operations.

Four public contracts / 4つの公開contract

This page is navigation, not a second specification. The linked Markdown and JSON files in the repository are canonical.

Form Definition Exact FormRef and desired/observed/output data, packaged as one immutable data-only Form Package.
spec/host-api/ Desired Resource discovery, preview/apply, lifecycle, fencing, and portable errors.
spec/interface-declaration/ Open Form-derived descriptors and their read-only host projection; data.indexed@1 is the current minimal four-operation descriptor.
spec/trust/ Publisher evidence, revocation, and independent API/Form/Package/provider version identities.

Schemas, conformance classes, generated inventory, and decisions support these four contracts; they are evidence and rationale, not additional product interfaces. Start from spec/README.md.

Independent version streams / 独立したversion

Similar-looking version numbers do not imply shared stability or a synchronized release.

API GROUP

`v1alpha1`

Protocol envelope, discovery, and lifecycle semantics. Still allowed to change incompatibly.

FORM

Per-Form SemVer

Each desired schema has its own exact FormRef and schema digest.

PACKAGE

Package SemVer

Immutable data-only bytes and evidence for one exact definition.

PROVIDER

`v1.0.1` published

The supported provider compatibility line, signed and verified by direct Terraform and OpenTofu Registry installation.

Evidence boundary / 証拠の境界

Implemented and published

Normative schemas and canonical I-JSON handling.
Closed local Form Package verifier and fixture corpus.
Generated 34-Form inventory and typed provider surface.
Provider v1.0.1 Registry readback with both CLIs.
All 34 signed immutable Form Package releases.
Protected exact-10 portable-standard admission evidence.

Limits on stronger claims

The API is still forms.takoform.com/v1alpha1.
The remaining 24 published packages are not admitted.
The retained Takosumi report proves only the selected 10 on that host.
Other hosts must publish their own exact support and lifecycle evidence.

Graduation from v1alpha1 has additional multi-host, stability, Interface materialization, deprecation, and revocation requirements. Read the canonical versioning policy.

Specification仕様