diff --git a/docs/parameter-registry-additions.md b/docs/parameter-registry-additions.md new file mode 100644 index 0000000..5b03fbb --- /dev/null +++ b/docs/parameter-registry-additions.md @@ -0,0 +1,1280 @@ +# 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.*