| Install pipeline | The two-phase flow every install command runs: planning, then commit. | Installation |
| Planning | Phase 1: turn a command into a delta; no resolution, no lockfile reads, no writes. | Planning |
| Commit | Phase 2: the transaction that resolves, composes, materializes, and writes atomically. | Commit |
| Resolve-all / Compose / Apply | Commit’s three phases. The first two are read-only; the journal opens at Apply. | The three phases |
| Delta | Additions (the user’s specifier verbatim) plus removals (bare names); facet install produces an empty delta. | The delta |
| Addition / reproduction | The structural discriminator: non-exact additions never trust the lockfile for version resolution; reproductions and exact additions do. | The delta |
| Desired set | The manifest’s facets after the delta is merged in memory. | Sequence |
| Install lock | The per-project advisory lock ensuring one install at a time. | Sequence |
| Journal | The log in which every materialization write records its inverse operation, replayed in reverse on failure. | Commit |
| Materialization | Deciding each asset’s effective identity, then writing the result into each selected adapter’s storage. | Materialization |
| Disposition | How a project materializes one authored asset: authored, aliased, or omitted. | Dispositions |
| Materialization override | A project’s recorded aliased or omitted intent for one authored asset, stored in facets.json. Authored is the absence of an override. | Recording intent |
| Materialization namespace | The logical space asset types compete for names in: skills and commands share one, agents have their own. | Namespaces |
| Collision group | Two or more assets claiming one logical identity (scope, namespace, folded effective name). | Collisions |
| Claimant | One member of a collision group — the facet, asset, and disposition that arrived at the contested name. | Collisions |
| Stale override | An override naming an asset the resolved version no longer contains. Pruned on a successful commit; blocking drift under frozen mode. | Stale overrides |
| Ownership transfer | A name moving between facets across one install. Deletion is keyed by effective identity, so the new owner’s file survives. | Drift removal |
| Install receipt | The machine-local, per-project record (schema 0.3) under $FACET_DIR/receipts/ recording asset ownership, owned authored paths, and each asset’s disposition for offline removal. The sole authority for deletion. Omitted assets never appear. | Install receipt |
| Tracked materialization | An asset on disk that the install receipt records. Only tracked identities may be deleted. | Ownership |
| Untracked materialization | An asset on disk that no receipt record covers — a pulled lockfile you never installed, or a hand-written file. Never deleted; reconciled only when the desired set names its identity, which makes it tracked. | Ownership |
| Reconciled | Brought to the desired state: written, or verified byte-identical to what would have been written. Either outcome records the identity as tracked. | Ownership |
| Remaining facet | A facet that stays declared after a removal. The removal-only short circuit requires every remaining materialization to be tracked; that is necessary, not sufficient. | Removal-only short circuit |
| Drift removal | Deleting every tracked effective identity no longer claimed by any desired asset, computed from the receipt, entirely offline. Runs before any write. | Drift removal |
| Orphan-on-pull | The recoverable state where a teammate’s removal reaches you via git pull; the receipt still remembers. | Drift removal |
| Tri-write | The atomic commit of facets.json, facets.lock, and the receipt together; failure leaves all three unchanged. | Transactional tri-write |
| Lockfile | facets.lock — resolved installation state: tagged source, exact version, integrity, and per-asset entries carrying a disposition plus per-file { path, integrity } records. | Lockfile |
| Cache | The machine-local content-addressed store for fetched facet payloads under $FACET_DIR/cache/. | facet install |
