Files
Renderive/render_3D/datoviz/spec/drp2/AUTHORITY.md
T
2026-08-14 01:54:38 +08:00

2.0 KiB

DRP2 Authority

This file defines how to resolve DRP2 spec conflicts.

Source-Of-Truth Order

  1. Protocol prose for the active command contract: COMMANDS.md, LIFETIMES.md, ERRORS.md, CAPABILITIES.md, VERSIONING.md, and CONFORMANCE.md.
  2. Active JSON schemas under schema/ as the machine-checkable mirror of the prose contract.
  3. Fixture files under fixtures/ as executable examples and regression vectors.
  4. Runner behavior in fixtures/RUNNER.md and the repository tools that implement it.
  5. Recording, roadmap, and feasibility notes under recording/ and roadmap/.

If an active schema disagrees with command, lifetime, or error prose, the prose wins until the schema is updated. If a fixture disagrees with both prose and schema, fix the fixture or promote a contract change through prose first.

Ownership

COMMANDS.md owns the human active/deferred command boundary. The schema README and schema files are the checkable mirror and should not independently promote command families.

LIFETIMES.md owns object lifetime, encoder/pass state, and submitted-work rules. ERRORS.md owns error selection when more than one validation failure could apply.

Fixtures should extend the active contract; they should not introduce normative behavior that cannot be read from prose and active schemas.

Maintenance Rules

  1. Prefer executable fixture coverage over prose-only rule additions.
  2. Keep DRP2 narrow; promote deferred commands only when current scene, runtime, browser replay, or conformance work exposes a concrete validated need.
  3. Do not allow public DRP2 definitions to mention Vulkan or other backend-native handles.
  4. Keep scene API design, runtime implementation sequencing, and release status out of this directory unless they directly constrain the DRP2 contract.