TheRON/otivm
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
44ee1c8a10cefeede7af6be5a6c1f496e51b56ce
otivm/docs/parameter-registry-additions.md
TheRON e38af68158 Initial commit
2026-04-30 03:51:06 -04:00

50 KiB
Raw Blame History

Parameter Registry — Consolidated Additions

Derived from corpus review: docs/law/, docs/commerce/, docs/economy/

Date: 2026-04-30

Status: Ready for project owner review before admission to docs/parameter-registry.md

Prepared by: Game Development Assistant

Editorial Notes

The existing registry (docs/parameter-registry.md, dated 2026-04-28) covers twelve canonical actor parameters and supporting city, scenario, and relation parameters. The corpus review identified two categories of new material:

Category A — New parameters not present in any form in the existing registry. These require admission through the standard three-test process.

Category B — Clarifications or extensions to existing parameters. These do not add new tokens but sharpen existing definitions or flag missing sub-fields.

All tokens follow Layer 3 naming convention (lowercase, snake_case) per terminology.md. Observable status uses the existing vocabulary: full / partial / hidden. Perceived vs true split is flagged where it applies — these require two records in schema, not one. This is the non-negotiable constraint from the existing registry.

Section 1 — Actor Parameters (new additions)

Parameters that live in the per-player database and drift over time.

MANUMISSION_STATE

token:    manumission_state
scope:    actor
layer:    roman
maturity: canonical

Definition: The formal legal status of freedom for an actor of servile origin. Distinct from IVS_ACCESSVS (which measures practical legal standing) because manumission can be granted in forms that confer freedom without full citizen rights. A freedman may be manumitted, legally free to trade, and still face social ceilings that limit contract enforceability. Captures the gap between formal liberation and practical standing.

Type: enum — enslaved / informally_freed / formally_freed / citizen
Observable: full — the actor knows their own legal status, though others may dispute it
Perceived vs true: applies — others may treat a formally freed actor as if informally freed, creating a gap between legal reality and social treatment

Drift mechanics:

  • Changes through legal manumission events only — not through drift
  • Affects IVS_ACCESSVS, AVCTORITA starting band, and contract enforceability

Background starting values:

  • Freedman Trader: formally_freed
  • All others: citizen or not applicable

Source scenario: DIALOGUE-LAW-0002 (The Captive's Inheritance)

KNOWLEDGE_ASSET

token:    knowledge_asset
scope:    actor
layer:    universal
maturity: canonical

Definition: Information held exclusively by an actor that has market or legal value independent of their formal status. The captive who knows names, seals, and inheritance amounts that no one else can verify. The captain who knows route measurement data no rival has collected. The scribe who knows which accounts do not balance. Knowledge assets are non-transferable in the normal sense — stealing them requires the holder's cooperation or death. This creates unique leverage structures unavailable to holders of physical assets.

Type: qualitative — present / absent, with estimated_value
Observable: hidden to others, full to holder
Perceived vs true: applies strongly — the holder knows what they know; others estimate its value from signals

Drift mechanics:

  • Increases through deliberate information collection (route measurement, account access)
  • Decreases through disclosure, documentation, or death of the holder
  • Separate from mercatus_scientia (commercial knowledge) — this is specific, exclusive, and often non-commercial in origin

Source scenarios: DIALOGUE-LAW-0002, DIALOGUE-COMMERCE-0002, DIALOGUE-COMMERCE-0003

REPLACEMENT_COST

token:    replacement_cost
scope:    actor
layer:    universal
maturity: canonical

Definition: The true cost of replacing an actor's functional contribution to a venture or household, including time to find, train, and verify a substitute. Distinct from wage rate. A trusted clerk with six years of account knowledge has a replacement cost that far exceeds their monthly wage. This parameter governs why owners hesitate to dismiss competent actors even when cheaper alternatives are visible, and why the captain values his crew's loyalty as a scarce asset.

Type: estimated quantity in denarii-equivalent
Observable: partial — the owner estimates it; the actor may not know how high it is
Perceived vs true: applies — owners systematically underestimate replacement cost until a departure forces them to discover it

Drift mechanics:

  • Increases with tenure, specialisation, and demonstrated reliability
  • Decreases when skills become commoditised or when substitutes enter the market
  • Relevant to skilled_labor_scarcity at the city level

Source scenarios: DIALOGUE-LAW-0001, DIALOGUE-LAW-0002, DIALOGUE-COMMERCE-0001

DEBT_COMPLETION_STATE

token:    debt_completion_state
scope:    actor
layer:    roman
maturity: canonical

Definition: Whether a bonded service arrangement has been satisfied at the point of a triggering event (death, dispute, early termination). The hinge of DIALOGUE-LAW-0001: the merchant entered bondage to shield his household; he died mid-term; the contract wording determines whether service was complete, partial, or void. This parameter has no equivalent in modern law and cannot be collapsed into a simple debt_balance — the question is not how much was owed but whether the form of service was completed.

Type: enum — in_progress / satisfied / disputed / void_at_death / transferred
Observable: partial — parties know their own interpretation; the legal resolution is uncertain until ruled upon
Perceived vs true: applies — creditor and family hold different readings of the same document

Drift mechanics:

  • Set at contract execution; changes only through completion, dispute, or death event
  • Affects household liability exposure directly

Source scenario: DIALOGUE-LAW-0001 (The Fallen Beam)

SUCCESSION_STATE

token:    succession_state
scope:    actor
layer:    roman
maturity: canonical

Definition: The actor's current position in a family inheritance structure — whether they are the designated heir, a secondary heir, a disinherited party, or a potential heir under a will not yet executed. Affects alliance formation, marriage negotiation, and creditor behaviour immediately when it changes. Not the same as wealth — a noble younger son may have high succession_state expectation and low liquiditas.

Type: enum — primary_heir / secondary_heir / undetermined / disinherited / independent
Observable: partial — formal wills are known; informal intentions and changes are not
Perceived vs true: applies strongly — DIALOGUE-LAW-0003 turns entirely on this gap

Drift mechanics:

  • Changes through will revision, death of primary heir, adoption, or disinheritance
  • Each change triggers immediate alliance_pipeline repricing by other actors
  • Lag: formal changes are immediate; social recognition takes weeks

Source scenario: DIALOGUE-LAW-0003 (The Heir's Oath)

HOUSEHOLD_AUTHORITY_INDEX

token:    household_authority_index
scope:    actor
layer:    roman
maturity: canonical

Definition: The degree to which an external authority (paterfamilias, patron, guild) can override the actor's legal decisions. Distinct from IVS_ACCESSVS (the actor's own standing to act) — this is the external constraint on that standing. A 22-year-old freeborn Roman male has full IVS_ACCESSVS in theory but may still be overridden by a living paterfamilias in practice. The parameter captures the gap between legal adulthood and practical autonomy.

Type: ordinal — none / low / medium / high / absolute
Observable: partial — formal authority is documented; practical extent depends on willingness to enforce, which is not always known

Drift mechanics:

  • Decreases with age, demonstrated independence, and paterfamilias death
  • Increases with adoption into a powerful household or formal guardianship appointment
  • Background-specific: Noble Younger Son starts high; Former Legionary starts low

Source scenario: DIALOGUE-LAW-0003 (The Heir's Oath)

SOURCE_CONTROL_STATE

token:    source_control_state
scope:    actor
layer:    universal
maturity: canonical

Definition: Whether the actor has secured access to goods or raw materials before they reach visible markets — standing timber, unmined ore, grain fields before harvest, undyed wool before processing. The first of the seven principles in DIALOGUE-COMMERCE-0004. Source control generates margin before price discovery occurs. Without it, the actor competes on visible goods at market prices. With it, the actor names terms.

Type: qualitative — absent / partial / secured, per commodity
Observable: hidden to competitors; full to holder
Perceived vs true: applies — the holder knows what they control; competitors estimate from observable purchasing patterns

Drift mechanics:

  • Acquired through forward contracts, land rights, and supplier relationships
  • Lost through contract expiry, seizure, competitor entry, or supply exhaustion
  • Connects to bottleneck_control_state — source control often creates bottleneck control

Source scenario: DIALOGUE-COMMERCE-0004 (The Merchant Engine)

BOTTLENECK_CONTROL_STATE

token:    bottleneck_control_state
scope:    actor
layer:    universal
maturity: canonical

Definition: Whether the actor controls a scarce input on which multiple output markets depend. Rope, pitch, dry timber before a disaster; skilled shipwrights during a wartime commission; water during a drought. Distinct from source_control_state (which is about raw material origin) — bottleneck control is about a necessary intermediate that cannot be substituted easily. The actor who controls the bottleneck does not need to compete on price.

Type: qualitative — absent / partial / controlling, per input category
Observable: hidden until the bottleneck is tested; then immediately apparent
Perceived vs true: applies — holders may not realise they hold a bottleneck until a disruption event reveals it (as in DIALOGUE-LAW-0009)

Drift mechanics:

  • Created by disaster, seasonal scarcity, or deliberate accumulation
  • Destroyed by new supply entering the market, substitution, or state requisition

Source scenarios: DIALOGUE-LAW-0009, DIALOGUE-COMMERCE-0004

TRANSFORMATION_MARGIN

token:    transformation_margin
scope:    actor
layer:    universal
maturity: provisional

Definition: The price differential captured by the actor between a good's raw form and its finished or processed form. The tree is not the mast. Ore is not the hinge. Grain is not bread. The actor who controls transformation captures margin that neither raw material producers nor end buyers can access. Distinct from trade margin (buy low, sell high at the same level of processing).

Type: ratio or denarii-equivalent per unit
Observable: partial — the actor knows their own margin; competitors estimate it
Maturity note: provisional pending research into documented Roman processing price differentials

Source scenario: DIALOGUE-COMMERCE-0004 (The Merchant Engine)

Section 2 — City Parameters (new additions)

Parameters shared across actors, anchored to a city substrate.

SKILLED_LABOR_SCARCITY

token:    skilled_labor_scarcity
scope:    city
layer:    universal
maturity: canonical

Definition: The availability of specialised craftsmen — shipwrights, architects, engineers, master scribes, skilled physicians — relative to demand. Distinct from porter_availability (unskilled labour). Skilled labour scarcity affects venture cost, construction timelines, and the premium paid for actors with rare expertise. It is the city-level expression of the actor-level replacement_cost problem.

Type: ordinal — abundant / adequate / tight / scarce / critical
Observable: partial — merchants and builders sense tightness through wage pressure and wait times; the precise supply is not publicly known

Drift:

  • Increases with disaster events, military requisition, disease outbreaks
  • Decreases when skilled workers migrate toward high-wage opportunities
  • Seasonal component: construction season peaks demand

Source scenarios: DIALOGUE-LAW-0004, DIALOGUE-LAW-0005

LICENSING_STATE

token:    licensing_state
scope:    actor
layer:    roman
maturity: canonical

Definition: Whether a specific business activity has been formally permitted by the relevant authority. Operating without licence creates liability exposure even if the activity itself is lawful. The licence is not the permission to act — it is protection against later challenge. An unlicensed recovery house that serves the same function as a licensed one faces different legal exposure after the first death on the premises.

Type: enum — unlicensed / applied / licensed / suspended / revoked
Observable: full to holder; full to authorities; partial to the public

Drift mechanics:

  • Acquired through formal application and fee payment
  • Lost through violation, non-renewal, or political disfavour
  • Affects IVS_ACCESSVS modifier for the specific activity

Source scenario: DIALOGUE-LAW-0007 (The Lawful Thirst)

RECURRING_DEMAND_PATTERN

token:    recurring_demand_pattern
scope:    city
layer:    universal
maturity: canonical

Definition: A predictable, lawful market opportunity that emerges from regular human behaviour — post-feast illness, gambling losses, festival grief, morning-after recovery, seasonal harvest pressure. Felix's core commercial lens across the law and commerce series. Distinct from rumor_velocity (which is about information speed) and from scenario-specific events. Recurring demand patterns are structural, not triggered.

Type: qualitative catalogue per city — list of identified patterns with frequency and magnitude estimates
Observable: full to experienced commercial actors; invisible to those who only watch visible goods

Drift:

  • Stable patterns change slowly with population and urban density
  • Event-amplified patterns spike temporarily then return to baseline

Source scenarios: DIALOGUE-LAW-0006, DIALOGUE-LAW-0007

INFRASTRUCTURE_STANDARD_STATE

token:    infrastructure_standard_state
scope:    city
layer:    universal
maturity: canonical

Definition: The current regulatory requirement for construction quality — crane bracing standards, warehouse fire separation, pier load limits. Upgrades after disaster events through emergency edicts. Before an edict: the standard is whatever survives inspection. After: the standard is written and enforceable. Affects licensing_state for all construction and storage ventures, and creates retroactive liability exposure for existing structures that do not comply.

Type: ordinal — absent / informal / codified / enforced
Observable: full once promulgated; actors may not know what the new standard requires until they apply for licence renewal

Drift:

  • Jumps after disaster events ("law after fear, as usual" — Crispus)
  • Erodes slowly during periods of stable governance as enforcement lapses

Source scenario: DIALOGUE-LAW-0011 (The Harbor Tremor)

REPORTING_OBLIGATION

token:    reporting_obligation
scope:    city
layer:    roman
maturity: canonical

Definition: A formal duty, created by edict, requiring actors to disclose specific observations to authorities under penalty. Once enacted, silence about a known hazard becomes a punishable act rather than a neutral choice. The maritime anomaly edict in DIALOGUE-LAW-0013 is the canonical example. Must be paired with false_report_penalty to prevent abuse. Without the penalty for silence, under-reporting is rational. Without the penalty for false reports, over-reporting becomes weaponisable.

Type: binary per activity category — obligated / not_obligated
Observable: full once promulgated

Drift:

  • Created by disaster-response edicts
  • Rarely revoked; more often amended
  • Interacts with duty_to_warn_state — a general duty may exist before a specific edict formalises it

Source scenario: DIALOGUE-LAW-0013 (The Current Edict)

INSTITUTIONAL_MEMORY_STATE

token:    institutional_memory_state
scope:    city
layer:    universal
maturity: provisional

Definition: Whether lessons from a disaster have been encoded into durable records, procedures, training, and enforcement rather than remaining in individual memory. Chresimus's warning: "if the tablets vanish, next generation rediscovers drowning." Individual actors carry survival_memory_bias; this parameter tracks whether the city itself has institutionalised the lesson. Degrades over time without active maintenance.

Type: ordinal — absent / informal / documented / enforced / embedded
Observable: partial — the presence of records is visible; whether they are used and accurate is not

Maturity note: provisional — the measurement framework for this parameter requires further design

Source scenario: DIALOGUE-LAW-0013

OUTPOST_STATE

token:    outpost_state
scope:    city
layer:    universal
maturity: canonical

Definition: Whether a commercial enterprise has established a trusted local presence in a given port — a rented room, a resident clerk, a locked chest, an account board, a local guide. The captain's minimum viable intelligence node. Enables early information access, reduces delayed_knowledge, and creates first_mover_window advantages. Each city in the network either has an outpost or does not. The outpost is not a warehouse or a factor — it is an information and trust anchor.

Type: binary per city — present / absent
Observable: full to the owner; partial to rivals (they can observe activity but not the contents)

Drift:

  • Created through deliberate investment and local relationship building
  • Lost through abandonment, agent failure, or political disruption

Source scenarios: DIALOGUE-COMMERCE-0002, DIALOGUE-COMMERCE-0003

Section 3 — Scenario Parameters (new additions)

Parameters that exist only within a scenario's active window.

CLASSIFICATION_STATE

token:    classification_state
scope:    scenario
layer:    universal
maturity: canonical

Definition: The legal category assigned (or contested) for a person or asset by an authorising body. The captured ship's human cargo in DIALOGUE-LAW-0004 are neither slaves, free persons, nor prisoners until classified. Classification determines which legal regime applies, which actors have standing to act, and what the asset or person is worth. The scenario teaches that authority often begins by deciding classifications, not by delivering justice.

Type: enum — unclassified / pending / classified (with assigned category) / contested
Observable: partial — the assigning authority knows its own ruling; affected parties learn through notification or enforcement

Perceived vs true: applies strongly — a person may be legally classified as one thing while being treated as another

Source scenarios: DIALOGUE-LAW-0004, DIALOGUE-LAW-0005

FOREIGN_STATUS_CLAIM

token:    foreign_status_claim
scope:    actor
layer:    roman
maturity: canonical

Definition: A pending assertion by a foreign-origin actor that their status or rights under a foreign legal instrument should be recognised by Roman authority. Damaros's claim in DIALOGUE-LAW-0005: he was lawfully requisitioned under enemy wartime statute; Rome must decide whether to honour that law to exonerate him, or deny it and face the reciprocity consequence for Roman craftsmen captured abroad. The claim is not the same as having the claim recognised.

Type: enum — not_filed / pending / recognised / rejected / under_appeal
Observable: full to the claimant; partial to authorities (they know what was filed, not what is true)

Source scenario: DIALOGUE-LAW-0005 (The Captive Shipwright)

CAUSATION_PROOF_THRESHOLD

token:    causation_proof_threshold
scope:    scenario
layer:    universal
maturity: canonical

Definition: The evidentiary standard required to file a complaint that survives legal challenge — not merely the standard to believe something happened, but to demonstrate it in a way that creates an enforceable claim. Distinct from IVS_ACCESSVS (standing to file) — a person may have standing and insufficient proof simultaneously. The threshold varies by claim type: physical damage requires different evidence than fraud or negligence.

Type: ordinal — unachievable / very_high / high / standard / low
Observable: partial — actors know what they have; whether it meets the threshold is determined by the magistrate, not the claimant

Source scenarios: DIALOGUE-LAW-0001, DIALOGUE-LAW-0006, DIALOGUE-LAW-0010

COLLUSION_EVIDENCE_STATE

token:    collusion_evidence_state
scope:    scenario
layer:    universal
maturity: canonical

Definition: Whether documentary or witness evidence exists linking two actors in coordinated harm. The Capua vendor and Ostia healer scenario: their coordination may be real, imagined, or opportunistic coincidence. The evidence state is not the same as whether coordination occurred — it is what can be demonstrated. Hidden to all actors initially; revealed through investigation.

Type: ordinal — none / suggestive / circumstantial / strong / conclusive
Observable: hidden — investigators must assemble it; defendants know what they did but not what has been observed

Perceived vs true: applies — the investigator's evidence assessment may differ from the legal reality

Source scenario: DIALOGUE-LAW-0006 (The Poison and the Cure)

VENTURE_GOVERNANCE_STATE

token:    venture_governance_state
scope:    scenario
layer:    universal
maturity: canonical

Definition: Whether a formal instrument exists defining ownership shares, binding authority, liability allocation, profit distribution, and succession rules for a multi-party venture. DIALOGUE-LAW-0008 in its entirety: without this instrument, no cart should move. With it, every question has an answer. The absence of governance is itself a governance state — one in which the most aggressive actor wins by default.

Type: enum — absent / draft / executed / disputed / dissolved
Observable: full — the instrument either exists or it does not

Drift mechanics:

  • Absent at venture formation; created through negotiation
  • Disputed when partners disagree about interpretation
  • Dissolved when the venture ends or a partner exits

Source scenarios: DIALOGUE-LAW-0007, DIALOGUE-LAW-0008

BINDING_AUTHORITY

token:    binding_authority
scope:    actor
layer:    roman
maturity: canonical

Definition: Which actor or actors have the right to commit the venture by signature — to execute contracts, accept deliveries, engage suppliers, and incur liabilities on behalf of the partnership. Until the venture_governance_state instrument is executed, binding authority is legally ambiguous. Felix's shout to the supplier ("yes") and Varro's counter-shout ("no") capture the problem exactly. The supplier's question — "whom to trust?" — has no answer without this parameter being defined.

Type: list of actor_ids with scope of authority
Observable: full once the governance instrument exists; contested before that

Source scenario: DIALOGUE-LAW-0008 (The Charter Quarrel)

ASSET_COMPLEMENTARITY

token:    asset_complementarity
scope:    relation
layer:    universal
maturity: provisional

Definition: Whether separately owned assets become significantly more valuable in combination than individually. Six bad trades combine into a shipyard in DIALOGUE-LAW-0009. Timber, rope, tackle, slips, pitch, and labour promises are each marginal in isolation; together they are a production facility. This is a derived, relational parameter — it cannot be measured per actor but only across a set of assets at a specific moment.

Type: qualitative — none / partial / significant / transformative
Observable: hidden until combination is attempted or a forcing event reveals it
Maturity note: provisional — the combinatorial logic requires design before this can be stored in schema

Source scenario: DIALOGUE-LAW-0009 (The Accidental Shipyard)

EMERGENCY_CONTRACT_WINDOW

token:    emergency_contract_window
scope:    scenario
layer:    universal
maturity: canonical

Definition: The time period during which premium contracts are available following an infrastructure disruption or disaster event, before price controls or state intervention closes the opportunity. Distinct from venture_window_days (which is market-driven) — the emergency window is disaster-triggered and collapses faster. Felix's urgent pressure in DIALOGUE-LAW-0009 is correct: the window is real, it is short, and acting without governance instruments is the specific risk.

Type: integer hours or days
Observable: partial — experienced actors estimate it from past events and current political signals; the precise close is unknown

Source scenario: DIALOGUE-LAW-0009

INFORMATION_ASYMMETRY_FLAG

token:    information_asymmetry_flag
scope:    scenario
layer:    universal
maturity: canonical

Definition: Whether one actor in a scenario possessed advance knowledge that others lacked — and acted on it. The broker in DIALOGUE-LAW-0009 and DIALOGUE-LAW-0010 sold surplus to all six at bargain prices before the crane disaster. Whether this was foresight, luck, or sabotage is the unresolved question. The flag marks the structural asymmetry regardless of cause. Hidden to the disadvantaged actors; Chresimus's primary investigative target.

Type: boolean — present / absent
Observable: hidden — inferred from pattern analysis and document investigation

Perceived vs true: applies — the disadvantaged actor believes they made a good deal; the flag marks whether someone else knew more

Source scenarios: DIALOGUE-LAW-0009, DIALOGUE-LAW-0010

DUTY_TO_WARN_STATE

token:    duty_to_warn_state
scope:    actor
layer:    universal
maturity: canonical

Definition: Whether an actor has accumulated sufficient knowledge of a hazard to create a legal or moral obligation to disclose it to those at risk. The central parameter of DIALOGUE-LAW-0012. The threshold at which knowledge becomes duty is not fixed — it depends on the specificity of the knowledge, the foreseeability of harm, and the actor's capacity to act. Before the threshold: silence is a choice. After: silence is exposure.

Type: enum — unaware / aware_no_duty / duty_emerging / duty_established
Observable: partial — actors know what they know; the legal threshold is determined retroactively, often after harm occurs

Perceived vs true: applies — the actor may believe they are below the threshold when a court would say they were not

Source scenario: DIALOGUE-LAW-0012 (The Secret Current)

SHARED_SECRET_LEVERAGE

token:    shared_secret_leverage
scope:    relation
layer:    universal
maturity: canonical

Definition: The mutual constraint created when multiple actors hold the same dangerous knowledge. Each actor's exposure depends on all others' silence. This is not a simple secrecy parameter — it is a relational one. Chresimus's solution in DIALOGUE-LAW-0012 is architecturally correct: if one discloses alone, five become targets; bind all six equally. The leverage runs in all directions simultaneously.

Type: qualitative — absent / present (with actor list)
Observable: full to the group; hidden from outside

Drift mechanics:

  • Created when multiple actors independently acquire the same hazardous knowledge
  • Dissolved by collective disclosure, death of any member, or external discovery

Source scenario: DIALOGUE-LAW-0012

HAZARD_KNOWLEDGE_TIMESTAMP

token:    hazard_knowledge_timestamp
scope:    actor
layer:    universal
maturity: canonical

Definition: The recorded moment at which an actor demonstrably knew of a hazard. Chresimus's core tool across the law arc — write the names, write the date. The timestamp is what transforms knowledge into legal exposure and what protects actors who disclosed promptly from those who did not. Without it, "I didn't know" is a viable defence. With it, the question shifts to "what did you do with what you knew?"

Type: ISO 8601 UTC timestamp (or null if not yet established)
Observable: full once documented; disputed before documentation

Source scenarios: DIALOGUE-LAW-0012, DIALOGUE-LAW-0013

EXONERATION_STATE

token:    exoneration_state
scope:    actor
layer:    roman
maturity: canonical

Definition: The formal reversal of a prior legal finding, including debt nullification, licence restoration, and official status repair. Distinct from FAMA recovery — exoneration restores legal standing immediately; reputation heals on its own timeline, which is slower. The captain in DIALOGUE-LAW-0013 is exonerated; his debts nullified, his licence restored. Tavern whispers continue. This gap between legal and social restoration is a first-class parameter.

Type: enum — not_applicable / under_review / exonerated / partially_exonerated
Observable: full legally; the social dimension (FAMA) recovers separately and partially

Source scenario: DIALOGUE-LAW-0013 (The Current Edict)

STATE_PATRONAGE_CHANNEL

token:    state_patronage_channel
scope:    scenario
layer:    roman
maturity: provisional

Definition: An informal promise of preferential access or reward from a state official, not written into any formal instrument. The magistrate's "priorities may align" in DIALOGUE-COMMERCE-0001. The channel is real — it generates real advantage — but it is deniable, and its reliability is unknown until tested. Distinct from formal contract (venture_governance_state) and from social capital (AVCTORITA). This is specifically state-to-private informal preference.

Type: enum — absent / implied / active / honoured / betrayed
Observable: hidden — the promise is oral and deniable; the outcome reveals itself only when the moment arrives

Maturity note: provisional — the frequency and reliability of such channels in Roman commerce requires further research calibration

Source scenario: DIALOGUE-COMMERCE-0001 (The First Hull)

COMMAND_AUTHORITY_SPLIT

token:    command_authority_split
scope:    scenario
layer:    universal
maturity: canonical

Definition: The formal separation of operational command authority (captain at sea) from ownership rights (the six on shore). Without this separation, maritime ventures collapse into disputes over every decision. With it, each domain has a sovereign. The captain's demand — "authority at sea unquestioned by men ashore" — is not arrogance; it is the structural requirement for any maritime venture to function. Connects to binding_authority but is specifically about the operational-ownership boundary.

Type: binary — defined / undefined, with authority_map if defined
Observable: full once the governance instrument exists

Source scenario: DIALOGUE-COMMERCE-0001

ROUTE_MEASUREMENT_STATE

token:    route_measurement_state
scope:    actor
layer:    universal
maturity: canonical

Definition: Whether systematic empirical data on a route's time, cost, reliability, and loss risk has been collected across multiple runs and is available to the actor. Before measurement: the actor guesses. After: the actor prices. The captain's experiment in DIALOGUE-COMMERCE-0003 — racing the land courier with a duplicate packet — is the canonical method. Route measurement is not map knowledge (ITINERIS_SCIENTIA); it is operational performance data that converts uncertainty into margin.

Type: ordinal — unmeasured / partially_measured / measured / continuously_updated
Observable: full to the actor who collected it; hidden to competitors

Drift mechanics:

  • Improves with each completed and documented run
  • Degrades when routes change (infrastructure disruption, political change, seasonal shift)

Source scenario: DIALOGUE-COMMERCE-0003 (The Captain's Measure)

NODE_AGENT_STATE

token:    node_agent_state
scope:    relation
layer:    universal
maturity: canonical

Definition: Whether a trusted agent is established and active at a specific port node. Distinct from outpost_state (which is about premises) — this is specifically about the person. The captain's principle: hold both ends. One agent in Ostia, one at the destination. Without agents at both ends, every voyage requires a merchant to travel. With them, information and instructions move without merchants.

Type: enum per location — absent / provisionally_placed / active / unreliable / lost
Observable: full to the network owner; partial to rivals

Drift mechanics:

  • Established through deliberate recruitment and relationship building
  • Degrades through neglect, rival recruitment, death, or disloyalty

Source scenarios: DIALOGUE-COMMERCE-0002, DIALOGUE-COMMERCE-0003

INFORMATION_MONOPOLY_WINDOW

token:    information_monopoly_window
scope:    scenario
layer:    universal
maturity: canonical

Definition: The period during which one actor receives information faster than competitors on a given route, creating durable commercial advantage. Collapses the moment rivals establish equivalent networks. Distinct from first_mover_window (a single-event advantage) — the information monopoly window is structural and ongoing, maintained through network investment. The captain's long-term commercial objective in the commerce arc.

Type: estimated days of lead time
Observable: hidden — the actor knows they have it; they do not know when it will end

Drift mechanics:

  • Created through route measurement, agent placement, and outpost establishment
  • Destroyed by rival network construction or information leak

Source scenario: DIALOGUE-COMMERCE-0003

GATEKEEPER_POTENTIAL

token:    gatekeeper_potential
scope:    actor
layer:    universal
maturity: provisional

Definition: The degree to which an currently obscure local actor is positioned to control access to something of future commercial or informational value — a dock clerk, a harbour master's assistant, a scribe at a merchant guild. Chresimus's lens: "today's nobody becomes tomorrow's gatekeeper." Identifying these actors before rivals creates durable relationship advantage at low cost. The value is invisible in the present; it becomes obvious only after the actor's position matures.

Type: qualitative assessment — low / medium / high
Observable: hidden to most; observable to those who read social position carefully
Maturity note: provisional — the criteria for identification require further design

Source scenario: DIALOGUE-COMMERCE-0002

Section 4 — Relation and Derived Parameters (new additions)

REPUTATION_DAMAGE_STATE

token:    reputation_damage_state
scope:    actor
layer:    roman
maturity: canonical

Definition: FAMA degradation that occurs before any legal judgment, triggered by public accusation alone. Distinct from FAMA (which tracks overall public reputation) — this captures the acute, event-triggered damage that precedes any formal resolution. The Capua vendor is beaten, not convicted. His trade suffers before the magistrate rules. Once damage occurs, it may persist even after exoneration. Volatility is the key characteristic.

Type: ordinal — none / minor / significant / severe / destroyed
Observable: partial — the actor hears what is said about them, but not all of it
Perceived vs true: applies — the actor may underestimate how damaged their FAMA is

Drift mechanics:

  • Spikes on public accusation, scandal, or visible failure
  • Recovers slowly, incompletely, and unevenly across different social groups
  • Recovery speed depends on AVCTORITA level and subsequent visible conduct

Source scenarios: DIALOGUE-LAW-0006, DIALOGUE-LAW-0013

COUNTERFACTUAL_CLAIM_STATE

token:    counterfactual_claim_state
scope:    scenario
layer:    universal
maturity: canonical

Definition: A legal or commercial claim based on what would have happened under different conditions — "if the old dock had remained, it would have collapsed in the earthquake." Not directly provable. Not directly disprovable. Persuasive to audiences who experienced the disaster; legally useless to Crispus without physical evidence. A distinct claim type because its evidentiary standard is structurally different from claims about actual events.

Type: enum — not_filed / filed / supported / unsupported / withdrawn
Observable: full — the claim either exists or it does not; whether it is valid is the contested question

Source scenario: DIALOGUE-LAW-0011 (The Harbor Tremor)

SURVIVAL_MEMORY_BIAS

token:    survival_memory_bias
scope:    actor
layer:    universal
maturity: provisional

Definition: The degree to which an actor's account of past events has been edited — unconsciously or deliberately — to emphasise their own foresight and correct prediction. Chresimus's observation: "survival edits archives quickly." Distinct from deliberate falsification — this is the structural tendency of survivors to remember their choices as wiser than they were. Affects the reliability of witness testimony and the credibility of historical accounts.

Type: qualitative — low / medium / high
Observable: hidden to the actor; visible to careful observers like Chresimus
Maturity note: provisional — requires a measurement methodology before schema implementation

Source scenario: DIALOGUE-LAW-0011

DEAD_WITNESS_STATE

token:    dead_witness_state
scope:    scenario
layer:    universal
maturity: canonical

Definition: Whether the primary actor whose testimony would resolve a case is deceased. Creates a permanent ceiling on causation_proof_threshold — the dead cannot be cross-examined. The broker's death in DIALOGUE-LAW-0010 does not merely remove one witness; it eliminates the only person who knew the complete picture. The state triggers permanent epistemic limitation: the question of intent can never be answered definitively.

Type: boolean — alive / dead (with deceased_at timestamp)
Observable: full — death is a public fact

Source scenario: DIALOGUE-LAW-0010 (The Broker's Last Wind)

NARRATIVE_CAPTURE_RISK

token:    narrative_capture_risk
scope:    city
layer:    universal
maturity: provisional

Definition: The probability that an unresolved event will be absorbed into popular myth before legal investigation completes. Once captured, evidence becomes harder to evaluate neutrally — witnesses remember what the story requires, not what they observed. The broker arc in DIALOGUE-LAW-0010 and 0011 illustrates: "the broker saved the harbor from beyond death" displaces the legal question of whether he caused the original disaster.

Type: ordinal — low / medium / high / captured
Observable: partial — the early signs are visible to Chresimus and Lentulus; the city at large experiences the narrative as truth

Maturity note: provisional — interaction with rumor_velocity and survival_memory_bias requires calibration

Source scenarios: DIALOGUE-LAW-0010, DIALOGUE-LAW-0011

ESTATE_LIABILITY_STATE

token:    estate_liability_state
scope:    scenario
layer:    roman
maturity: canonical

Definition: Whether a deceased actor's estate bears civil liability for harms they caused. Conditional on proof of intentional harm — Crispus's core constraint throughout the broker arc. Accidental harm, negligence, and coincidence are treated differently. Without proof of intent, the estate is shielded. With it, creditors and claimants may pursue assets. The parameter captures Roman law's specific treatment of posthumous civil liability, which differs significantly from modern frameworks.

Type: enum — shielded / under_review / liable / settled
Observable: partial — the legal position is uncertain until ruled upon; the estate's actual assets are known only through inventory

Source scenario: DIALOGUE-LAW-0010

RECORD_DESTRUCTION_FLAG

token:    record_destruction_flag
scope:    scenario
layer:    universal
maturity: canonical

Definition: Whether relevant documents have been deliberately removed or destroyed before investigation. Inferred from physical evidence (ash tray contents, floor scratches, cleared racks, suspiciously neat premises) rather than direct observation. Once flagged, it changes the evidentiary burden: the absence of records becomes itself evidence of concealment. Without the flag, missing documents are merely missing. With it, they are presumptively destroyed.

Type: boolean — not_flagged / flagged (with inference_basis)
Observable: inferred from physical investigation; never directly confirmed

Source scenario: DIALOGUE-LAW-0010

MANIFEST_INTEGRITY

token:    manifest_integrity
scope:    scenario
layer:    roman
maturity: canonical

Definition: Whether cargo documentation is authentic, complete, and consistent with actual cargo. Chresimus's primary lens in DIALOGUE-LAW-0004 (the prize ship): "if cargo was declared as timber or salt, many men hang by ink." Distinct from general LITTERAE (literacy and account-keeping capacity) — this is specifically the authenticity of a specific document at a specific moment. Falsified manifests affect classification outcomes, prize rights, and liability.

Type: enum — authentic / unverified / inconsistent / falsified / destroyed
Observable: partial — the document exists and can be read; whether it reflects reality requires investigation

Source scenario: DIALOGUE-LAW-0004

PARTNERSHIP_ALIGNMENT_STATE

token:    partnership_alignment_state
scope:    relation
layer:    universal
maturity: canonical

Definition: The degree of genuine agreement among co-venturers on ownership shares, operational authority, accounts, and decision rights — before any formal instrument is executed. Chresimus's warning: "if this succeeds, friendship shortens." The gap between declared cooperation and actual willingness to cede control. Distinct from venture_governance_state (which is about the formal instrument) — alignment is the underlying social reality that the instrument must capture or fail.

Type: ordinal — aligned / fragile / disputed / broken
Observable: hidden — each actor perceives their own willingness as reasonable and others' as deficient
Perceived vs true: applies strongly — "trust was the missing capital" (Varro)

Source scenarios: DIALOGUE-LAW-0007, DIALOGUE-LAW-0008

CARETAKER_INCENTIVE_STRUCTURE

token:    caretaker_incentive_structure
scope:    actor
layer:    universal
maturity: canonical

Definition: The degree to which a remote agent's compensation is tied to outcomes rather than fixed wage. The captain's operating principle and the six's caretaker design in DIALOGUE-COMMERCE-0002. "Free men often steal more carefully because they plan to stay" — Chresimus. The parameter captures whether the incentive structure creates alignment between agent behaviour and owner interest. Pure fixed wage creates one risk profile; pure outcome-linked creates another; the mixture is the design variable.

Type: ordinal — fixed_wage / partial_outcome / primarily_outcome / equity_stake
Observable: full to the owner who designed it; the agent may not know they are being compared against alternatives

Drift mechanics:

  • Set at agent engagement; renegotiated at major milestones
  • Affects remote_management_reliability directly

Source scenario: DIALOGUE-COMMERCE-0002

REMOTE_MANAGEMENT_RELIABILITY

token:    remote_management_reliability
scope:    actor
layer:    universal
maturity: canonical

Definition: Whether caretakers and agents perform correctly in the owner's absence. The test delivered mid-journey in DIALOGUE-COMMERCE-0002: warehouse rents collected, no theft, one rope shortage, two offers to buy slip rights refused, all stable. The parameter is never fully known in advance — it is revealed through periodic reports. The incentive structure (caretaker_incentive_structure) is the design variable; this parameter tracks the outcome.

Type: ordinal — unknown / unreliable / adequate / reliable / exceptional
Observable: revealed through reports; unknown during absence

Drift mechanics:

  • Improves with successful test cycles
  • Degrades under temptation, opportunity, or changed circumstances

Source scenario: DIALOGUE-COMMERCE-0002

DISPATCH_RECEIPT_INTEGRITY

token:    dispatch_receipt_integrity
scope:    relation
layer:    universal
maturity: canonical

Definition: Whether agents sign witnessed receipts confirming arrival time and condition of information packets at each node. Crispus's binding requirement in DIALOGUE-COMMERCE-0003. Without this data, the route measurement experiment produces impressions rather than evidence. With it, the data becomes the commercial advantage. The receipt is not the contract — it is the measurement instrument that makes the contract valuable.

Type: enum — absent / informal / witnessed / witnessed_and_timestamped
Observable: full — the receipt either exists or it does not

Source scenario: DIALOGUE-COMMERCE-0003

Section 5 — Extensions to Existing Parameters

These are not new tokens. They are clarifications or additions to parameters already in the registry, identified through corpus review.

AVCTORITA — perceived vs true split clarification

The existing registry notes that the actor infers their own AVCTORITA from social signals. The corpus makes explicit that this split is load-bearing in multiple scenarios:

  • The Failed Magistrate's AVCTORITA is falling faster than he knows (DIALOGUE-LAW-0001, CAST-OSTIA-0001)
  • The Freedman Trader's practical reputation has grown faster than his social recognition (CAST-OSTIA-0001)
  • The captain's AVCTORITA is destroyed by accusation before any legal finding, then partially restored by exoneration, but not fully restored by it (DIALOGUE-LAW-0013)

Schema implication already noted in existing registry: value_true and value_perceived must be separate records. This remains non-negotiable.

Addition: A third record is needed — value_social — tracking the current market consensus about an actor's AVCTORITA, which may differ from both the true value and the actor's self-assessment. This is what FAMA produces. Three records, not two.

IVS_ACCESSVS — post-exoneration modifier

The existing registry covers formal standing. The corpus adds:

After exoneration, IVS_ACCESSVS is restored legally but may remain practically impaired while FAMA recovers. The schema should support a practical_modifier field on IVS_ACCESSVS that can differ from the formal standing field during recovery periods.

OFFICIA_BVRDEN — hidden obligation component

The existing registry notes that the actor may underestimate informal obligations. The corpus confirms: in DIALOGUE-LAW-0001, the bonded service arrangement itself is an OFFICIA_BVRDEN item. The parameter should explicitly support both formal obligations (visible) and informal ones (partially hidden), with the split tracked separately.

Section 6 — Tokens Considered and Rejected

These were identified during corpus review and rejected for specific reasons.

Rejected token Reason
conspiracy_flag Too broad. Covers everything from coordinated pricing to sabotage. Use collusion_evidence_state for the evidence status and information_asymmetry_flag for the structural condition.
luck_parameter Not a parameter. Luck is the residual between preparation and outcome. It is not stored — it is the gap between expected and actual outcome.
moral_reputation Collapsed into FAMA. The distinction between commercial and moral reputation is valid in Roman life but does not require a separate parameter — it is captured by the audience and context fields on FAMA events.
political_timing_advantage Too broad as a standalone parameter. Covered by information_monopoly_window (structural) and state_patronage_channel (relational). The underlying mechanism is delayed knowledge reaching the actor before the market.
ghost_current_state Too scenario-specific. The underlying phenomenon is infrastructure_bottleneck_state with a geological trigger. The ghost current terminology belongs in UI text, not schema.
broker_foreknowledge Not a general parameter. The broker's possible foreknowledge is the unresolved question of the arc, not a storable value. Represented by information_asymmetry_flag and dead_witness_state.

Summary — New Tokens by Scope

Actor (13): manumission_state, knowledge_asset, replacement_cost, debt_completion_state, succession_state, household_authority_index, source_control_state, bottleneck_control_state, transformation_margin, foreign_status_claim, binding_authority, exoneration_state, route_measurement_state

City (7): skilled_labor_scarcity, licensing_state, recurring_demand_pattern, infrastructure_standard_state, reporting_obligation, institutional_memory_state, outpost_state

Scenario (11): classification_state, causation_proof_threshold, collusion_evidence_state, venture_governance_state, asset_complementarity, emergency_contract_window, information_asymmetry_flag, duty_to_warn_state, information_monopoly_window, command_authority_split, state_patronage_channel

Relation/Derived (13): reputation_damage_state, counterfactual_claim_state, survival_memory_bias, dead_witness_state, narrative_capture_risk, estate_liability_state, record_destruction_flag, manifest_integrity, partnership_alignment_state, caretaker_incentive_structure, remote_management_reliability, dispatch_receipt_integrity, shared_secret_leverage, hazard_knowledge_timestamp, gatekeeper_potential, node_agent_state

Total new tokens: 44 Canonical: 32 | Provisional: 8 | Extensions to existing: 3

Parameter Registry Additions — 2026-04-30 Prepared for project owner review. No token is admitted until reviewed. Uncertainty is a first-class record, not a comment. TheRON — single contributor. AI assistants implement, document, flag — do not direct.

Reference in New Issue View Git Blame Copy Permalink