machine .toml source > generated view > drift gate

Generated TOML

DECISIONS.toml

The machine projection, generated at .working/DECISIONS.toml. Uppercase because it is output: generated, never hand-authored truth.

About

A machine projection is a third generated-output class beside deterministic views and the curated changelog: a deterministic, byte-drift-gated TOML deliverable. The shipped projection is DECISIONS.toml, the machine counterpart to the composed DECISIONS.md view, projected from pending_decision, autonomous_decision, maintainer_decision, and preference_pattern.

Why

A machine consumer of the decision record should not have to parse Markdown or read four indexes and re-derive the supersession chain itself. The projection gives it one deterministic file with the join already computed, under exactly the same render, drift, and doctor gates as any declared view, with no new gate.

Description

The payload (projection contract v1) carries schema = 1 and projection = "decisions"; four arrays of tables, one per source type, each row sorted by numeric ID and projecting the full base record with x-<vendor> extension tables excluded as profile-owned data; and one [derived] table carrying the decision-resolution join's output (the effective and superseded pending-decision IDs, numerically sorted) and nothing beyond the closed transform vocabulary. The do-not-edit header is a leading TOML comment block naming sources, schema and generator versions, a source-set digest, and the regeneration command, with no timestamp.

How it works

The determinism requirements apply verbatim: UTF-8, LF, stable ordering, no locale-dependent sorting, no wall-clock content, no network access, and no model involvement. Advisory activity over a projection, an assistant-side prediction, dedup, or pattern-spotting pass, is a read-time activity outside the generator: the generator invokes no model and adds no model-generated interpretation. The views it renders reproduce the declared source records, so content those records carry, including assistant-authored text, still needs review.

Generated view

This file is itself the generated half of its pairs: it is one of the thirteen outputs the scaffolded manifest declares, rendered beside DECISIONS.md from the same four sources.

Value

A stable machine interface to the decision record with the current effective resolution precomputed, which helps prevent each consumer from re-implementing, and diverging on, the supersession walk.

Usage

  • Created by: opf render --write, gated on a valid whole-store verdict.
  • Updated by: regeneration only; hand edits are drift, reported by opf render --check and opf doctor.
  • Read by: machine consumers of the decision record; the byte drift gate.