What we claim, and what we do not
Disclosure
OPFiles is a draft standard with a reference implementation that ships incrementally. This page states plainly what the standard and its tooling establish, and the residuals they do not reach, so a reader is never more than one click from the limits.
Draft status and self-asserted conformance
The specification is a working draft and the reference tooling lands verb by verb. Until the validation tooling covers a given claim, conformance to that claim is self-asserted, and any report says so: an unqualified "conformant" claim is never emitted, by tooling or by prose. A conformance claim names its scope and which profiles were evaluated.
Residual coverage the gates do not reach
Each gate names what it does and does not decide. The residuals below are disclosed as part of the standard, not discovered after a gate fails:
- Changelog freeze checks that a published entry's bytes match a recorded digest; it does not judge whether the prose is accurate or complete.
- Range coverage checks that changelog entries tile every released version with no gap or overlap; it does not judge the quality of what they say.
- The unreleased worklog tail is reviewed rather than machine-frozen: before a release cut, entries are correctable in place, so review and version-control history, not a digest, are the control there.
- Store resolution confirms one declared store resolves; it cannot detect a second, unnamed store a project might also keep.
- The tracked-store check confirms the store is a tracked git repository whose pointer, recorded sync target, and actual remote agree; it does not verify that the repository is backed up, accessible, or hosted anywhere in particular.
- The single-writer lease leaves a propagation window between taking the lease and its reaching the sync target; the store-consistency divergence check is the overlapping control that catches a collision in that window, and the two together, not the lease alone, are the guard. In this build the cross-system sync step (opf sync) has not landed, so the lease is enforced single-host single-writer; cross-system enforcement arrives with sync.
- A base tool enforces only the base standard and the profiles it supports; a profile it does not support is recorded as present-but-unevaluated rather than failing base validation.
- The discovery token is a single exact string, stable within a base-schema major line: a mistyped or altered token is a cannot-evaluate that stops the tool, never a silent empty store.
- A host provider's conveniences call the external API of the host the target names. The egress bound is that named host and nothing else; the standard cannot vouch for the host's own behaviour beyond that bound.
- Public deliverables reach the product repository through
opf renderunder that repository's normal review flow; the quality of that review flow is the adopter's own discipline, which the standard requires to exist but does not itself gate.
Authorship, trademarks, and licence
OPFiles is a neutral, self-contained standard authored and maintained by Jeff Posluns and source-available under the Elastic License 2.0 (ELv2). AIQT and AIQT Guardrails are trademarks of Jeff Posluns; the standard's formal name, the AIQT Development Operational Standard, uses the AIQT trademark. AIQT Guardrails is one reference enforcement suite and one consumer of the standard, carried as a single optional profile; a base adopter need not adopt the suite.