Aetheria/docs/item-provenance-target.md
Meta Vens 30c316a303 Record the placeholder origin and in-place factory construction rulings
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 02:54:48 +02:00

101 lines
5.8 KiB
Markdown

# Item Provenance Target
Date: 2026-09-17
Status: target, rulings only. The substrate map, the identity/lifecycle/authority
table and the cut map are not written yet. This document owns the ends; a cut map
will own the means.
## Why
Aetheria's crafted items should already have the shape of the future economy.
Njordr (`F:\Projects\Njordr\docs\architecture\njordr.md`) tracks production and
distribution at the level of individual lots, and a lot's provenance is the DAG of
recipe runs and input lots that made it. Aetheria adopts that shape now, with its
current mocked quality, so later supply-chain stats plug into provenance that
already exists.
## Rulings (operator, 2026-09-17)
- **The manufacturer does not belong to a design.** `ItemData.Manufacturer` leaves
the catalog design.
- **A lot's provenance says who built it, where, and from what.** In Aetheria that
maps to:
- a specific **faction**;
- a specific **station**, meaning the stats of the factory item itself are
known, and that factory maps to an item instance in that station's inventory;
- a set of **item inputs**, each carrying its own provenance.
- **Branding is derived, not stored.** Provenance is enough to reconstruct the
branding of an item, with market segmentation appropriate to the production
quality achievable at that station. Branding is an Aetheria-layer projection;
Njordr's lot does not grow a brand field.
- **Provenance determines stats.** Today that means the mocked quality; later it
incorporates the supply chain.
Operator's words, for the parts a paraphrase could lose: "The lot provenance
should say who built it and where and from what ingredients, and in Aetheria that
maps to a specific faction, a specific station (meaning we have the stats for the
factory item itself as well, which should even map to an item instance in that
station's inventory in Aetheria), and a set of item inputs, carrying their own
provenance. That is enough to reconstruct the branding for that item, with market
segmentation appropriate to the production quality achievable at that station."
- **Terminus generates backwards (operator, 2026-09-17).** Terminus starts from the
output products that need to exist and synthesizes a fake economy to
materialize them: the product is chosen first, then a plausible faction,
station, factory and input lots that would have produced it. The forward
supply chain is Njordr's future direction, not Terminus scope. Operator's words:
"Right now, for Terminus, we want to go in the opposite direction: start with
the output products, and generate a fake economy to materialize those goods."
- **Synthesis recurses to mining, includes consumer goods, and feeds routes**
**(operator, 2026-09-17).** Backward generation runs all the way down to
extraction. Consumer goods are part of it, and routes move them between places,
which is meant to give Aetheria piracy gameplay. The aim is a convincing economy
without simulating one. Njordr's interspersed profile (shipment materialization
and interception) is the shape precedent, adopted as local typed state. Operator's
words: "right now we have no rules whatsoever for generating what looks like
economic activity. If we recurse the backwards generation all the way down to the
level of mining, we can get a convincing enough economy without actually
simulating one. Especially if we're accounting for consumer goods. Just add some
routes to move consumer goods around, and we can get a lot of bang for our buck.
Some decent piracy gameplay, even, which Aetheria feels empty without."
- **Scope: schema now, generation later (operator, 2026-09-17).** Backward
generation, routes and piracy come after Terminus ships
(`docs/three-gates-scope.md` owns that). The schema cut lands now: "I want the
schema cut now so that the shape of the data reflects the shape of the game we
want to build."
- **Terminus mint sites write a placeholder origin (operator, 2026-09-17; F0 (a)).**
Generation starts from branded items with specific role spreads and synthesizes
whatever provenance is needed to hit those properties. This pass does not
generate the crafting pyramid, so there is nothing honest to name for where
and from what; the origin says only which faction made it. Operator's words:
"since we are starting from branded items with specific role spreads, we
synthesize whatever provenance is necessary to hit those properties. Since
we're not going to bother generating every level of the crafting pyramid for
this pass, that also means there's no honest thing to put there, so A, I guess?"
- **Factories are built in place from raw materials (operator, 2026-09-17; F2,
next scope).** A factory's provenance terminates in extracted inputs at its own
station, not in another factory. Switching a factory to a different design
costs retooling, and so does a tech upgrade on a sub-assembly: a different
item filling the same role in an ingredient slot counts as a different design.
Operator's words: "these are things that should be buildable in-place out of
raw materials, with some cost for retooling every time you want to switch
designs (including tech upgrades on sub-assemblies, meaning a different item
with the same role filling an ingredient slot)".
## Consequences already visible
- `FactionProductData` currently stores a manufacturer, a brand name and flavour
text, and a per-role quality distribution, and `CraftedItemInstance.Product`
points at one. Under these rulings the brand an item shows is chosen from its
provenance, so an instance does not store which product it is.
- CultCache Studio's grouping of `GearData` by manufacturer
(`CultLib\docs\studio-grouping-cut.md`, Cut 4) is no longer the target.
## Not in scope
- A Njordr daemon, CultMesh, or any service integration. Aetheria stays
legacy-first; the lot model is local typed state in CultCache stores.