@agent-e/core 1.4.0 → 1.5.0

package/dist/index.js

@@ -30,11 +30,11 @@ __export(index_exports, {
   Executor: () => Executor,
   FEEDBACK_LOOP_PRINCIPLES: () => FEEDBACK_LOOP_PRINCIPLES,
   INCENTIVE_PRINCIPLES: () => INCENTIVE_PRINCIPLES,
-  LIVEOPS_PRINCIPLES: () => LIVEOPS_PRINCIPLES,
   MARKET_DYNAMICS_PRINCIPLES: () => MARKET_DYNAMICS_PRINCIPLES,
   MEASUREMENT_PRINCIPLES: () => MEASUREMENT_PRINCIPLES,
   MetricStore: () => MetricStore,
   OPEN_ECONOMY_PRINCIPLES: () => OPEN_ECONOMY_PRINCIPLES,
+  OPERATIONS_PRINCIPLES: () => OPERATIONS_PRINCIPLES,
   Observer: () => Observer,
   P10_SpawnWeightingUsesInversePopulation: () => P10_SpawnWeightingUsesInversePopulation,
   P11_TwoTierPressure: () => P11_TwoTierPressure,
@@ -96,9 +96,10 @@ __export(index_exports, {
   P7_NonSpecialistsSubsidiseSpecialists: () => P7_NonSpecialistsSubsidiseSpecialists,
   P8_RegulatorCannotFightDesign: () => P8_RegulatorCannotFightDesign,
   P9_RoleSwitchingNeedsFriction: () => P9_RoleSwitchingNeedsFriction,
+  PARTICIPANT_EXPERIENCE_PRINCIPLES: () => PARTICIPANT_EXPERIENCE_PRINCIPLES,
   PERSONA_HEALTHY_RANGES: () => PERSONA_HEALTHY_RANGES,
-  PLAYER_EXPERIENCE_PRINCIPLES: () => PLAYER_EXPERIENCE_PRINCIPLES,
   POPULATION_PRINCIPLES: () => POPULATION_PRINCIPLES,
+  ParameterRegistry: () => ParameterRegistry,
   PersonaTracker: () => PersonaTracker,
   Planner: () => Planner,
   REGULATOR_PRINCIPLES: () => REGULATOR_PRINCIPLES,
@@ -126,11 +127,11 @@ var DEFAULT_THRESHOLDS = {
   smokeTestWarning: 0.3,
   smokeTestCritical: 0.1,
   currencyInsulationMax: 0.5,
-  // Player Experience (P45, P50)
+  // Participant Experience (P45, P50)
   timeBudgetRatio: 0.8,
   payPowerRatioMax: 2,
   payPowerRatioTarget: 1.5,
-  // LiveOps (P51, P53)
+  // Operations (P51, P53)
   sharkToothPeakDecay: 0.95,
   sharkToothValleyDecay: 0.9,
   eventCompletionMin: 0.4,
@@ -184,7 +185,7 @@ var PERSONA_HEALTHY_RANGES = {
   Earner: { min: 0, max: 0.15 },
   Builder: { min: 0.05, max: 0.15 },
   Social: { min: 0.1, max: 0.2 },
-  Whale: { min: 0, max: 0.05 },
+  HighValue: { min: 0, max: 0.05 },
   Influencer: { min: 0, max: 0.05 }
 };
 var DEFAULT_TICK_CONFIG = {
@@ -221,7 +222,7 @@ var Observer = class {
       const curr = e.currency ?? defaultCurrency;
       switch (e.type) {
         case "mint":
-        case "spawn":
+        case "enter":
           faucetVolumeByCurrency[curr] = (faucetVolumeByCurrency[curr] ?? 0) + (e.amount ?? 0);
           break;
         case "burn":
@@ -243,6 +244,46 @@ var Observer = class {
           break;
       }
     }
+    const flowBySystem = {};
+    const activityBySystem = {};
+    const actorsBySystem = {};
+    const flowBySource = {};
+    const flowBySink = {};
+    for (const e of recentEvents) {
+      if (e.system) {
+        activityBySystem[e.system] = (activityBySystem[e.system] ?? 0) + 1;
+        if (!actorsBySystem[e.system]) actorsBySystem[e.system] = /* @__PURE__ */ new Set();
+        actorsBySystem[e.system].add(e.actor);
+        const amt = e.amount ?? 0;
+        if (e.type === "mint" || e.type === "enter") {
+          flowBySystem[e.system] = (flowBySystem[e.system] ?? 0) + amt;
+        } else if (e.type === "burn" || e.type === "consume") {
+          flowBySystem[e.system] = (flowBySystem[e.system] ?? 0) - amt;
+        }
+      }
+      if (e.sourceOrSink) {
+        const amt = e.amount ?? 0;
+        if (e.type === "mint" || e.type === "enter") {
+          flowBySource[e.sourceOrSink] = (flowBySource[e.sourceOrSink] ?? 0) + amt;
+        } else if (e.type === "burn" || e.type === "consume") {
+          flowBySink[e.sourceOrSink] = (flowBySink[e.sourceOrSink] ?? 0) + amt;
+        }
+      }
+    }
+    const participantsBySystem = {};
+    for (const [sys, actors] of Object.entries(actorsBySystem)) {
+      participantsBySystem[sys] = actors.size;
+    }
+    const totalSourceFlow = Object.values(flowBySource).reduce((s, v) => s + v, 0);
+    const sourceShare = {};
+    for (const [src, vol] of Object.entries(flowBySource)) {
+      sourceShare[src] = totalSourceFlow > 0 ? vol / totalSourceFlow : 0;
+    }
+    const totalSinkFlow = Object.values(flowBySink).reduce((s, v) => s + v, 0);
+    const sinkShare = {};
+    for (const [snk, vol] of Object.entries(flowBySink)) {
+      sinkShare[snk] = totalSinkFlow > 0 ? vol / totalSinkFlow : 0;
+    }
     const currencies = state.currencies;
     const totalSupplyByCurrency = {};
     const balancesByCurrency = {};
@@ -452,7 +493,8 @@ var Observer = class {
     for (const [name, fn] of Object.entries(this.customMetricFns)) {
       try {
         custom[name] = fn(state);
-      } catch {
+      } catch (err) {
+        console.warn(`[AgentE] Custom metric '${name}' threw an error:`, err);
         custom[name] = NaN;
       }
     }
@@ -529,6 +571,13 @@ var Observer = class {
       sharkToothValleys: this.previousMetrics?.sharkToothValleys ?? [],
       eventCompletionRate: NaN,
       contentDropAge,
+      flowBySystem,
+      activityBySystem,
+      participantsBySystem,
+      flowBySource,
+      flowBySink,
+      sourceShare,
+      sinkShare,
       custom
     };
     this.previousMetrics = metrics;
@@ -671,6 +720,13 @@ function emptyMetrics(tick = 0) {
     sharkToothValleys: [],
     eventCompletionRate: NaN,
     contentDropAge: 0,
+    flowBySystem: {},
+    activityBySystem: {},
+    participantsBySystem: {},
+    flowBySource: {},
+    flowBySink: {},
+    sourceShare: {},
+    sinkShare: {},
     custom: {}
   };
 }
@@ -703,7 +759,7 @@ var P1_ProductionMatchesConsumption = {
         severity: 7,
         evidence: { scarceResources: violations, dominantRole: dominantRole?.[0], dominantShare },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: "decrease",
           magnitude: 0.15,
           reasoning: "Lower production cost to incentivise more production."
@@ -737,7 +793,8 @@ var P2_ClosedLoopsNeedDirectHandoff = {
         severity: 5,
         evidence: { backlogResources, velocity },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "increase",
           magnitude: 0.2,
           reasoning: "Raise market fees to discourage raw material listings. Direct hand-off at production zones is the correct channel."
@@ -767,7 +824,7 @@ var P3_BootstrapCapitalCoversFirstTransaction = {
               severity: 8,
               evidence: { resource, totalProducers, supply },
               suggestedAction: {
-                parameter: "productionCost",
+                parameterType: "cost",
                 direction: "decrease",
                 magnitude: 0.3,
                 reasoning: "Producers cannot complete first transaction. Lower production cost to unblock bootstrap."
@@ -786,7 +843,7 @@ var P4_MaterialsFlowFasterThanCooldown = {
   id: "P4",
   name: "Materials Flow Faster Than Cooldown",
   category: "supply_chain",
-  description: "Input delivery rate must exceed or match production cooldown rate. If producers craft every 5 ticks but only receive raw materials every 10 ticks, they starve regardless of supply levels.",
+  description: "Input delivery rate must exceed or match production cooldown rate. If producers produce every 5 ticks but only receive raw materials every 10 ticks, they starve regardless of supply levels.",
   check(metrics, _thresholds) {
     const { supplyByResource, populationByRole, velocity, totalAgents } = metrics;
     const totalSupply = Object.values(supplyByResource).reduce((s, v) => s + v, 0);
@@ -799,7 +856,7 @@ var P4_MaterialsFlowFasterThanCooldown = {
         severity: 5,
         evidence: { avgSupplyPerAgent, velocity, totalRoles },
         suggestedAction: {
-          parameter: "yieldRate",
+          parameterType: "yield",
           direction: "increase",
           magnitude: 0.15,
           reasoning: "Low supply per agent with stagnant velocity. Increase yield to compensate."
@@ -814,7 +871,7 @@ var P4_MaterialsFlowFasterThanCooldown = {
         severity: 4,
         evidence: { avgSupplyPerAgent, totalSupply, totalAgents },
         suggestedAction: {
-          parameter: "yieldRate",
+          parameterType: "yield",
           direction: "decrease",
           magnitude: 0.2,
           reasoning: "Raw materials piling up. Extractors outpacing producers."
@@ -842,7 +899,7 @@ var P60_SurplusDisposalAsymmetry = {
           discount: thresholds.disposalTradeWeightDiscount
         },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: "decrease",
           magnitude: 0.1,
           reasoning: `${(disposalTradeRatio * 100).toFixed(0)}% of trades are surplus disposal. Price signals unreliable as demand indicators. Lower production costs to shift balance toward deliberate production-for-sale. ADVISORY: Weight disposal-trade prices at ${thresholds.disposalTradeWeightDiscount}\xD7 in index calculations.`
@@ -885,7 +942,8 @@ var P5_ProfitabilityIsCompetitive = {
           population: populationByRole[dominantRole]
         },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "increase",
           magnitude: thresholds.maxAdjustmentPercent,
           reasoning: `${dominantRole} share at ${((roleShares[dominantRole] ?? 0) * 100).toFixed(0)}%. Likely stampede from non-competitive profitability formula. Raise market friction to slow role accumulation.`
@@ -911,7 +969,7 @@ var P6_CrowdingMultiplierOnAllRoles = {
           severity: 5,
           evidence: { role, share },
           suggestedAction: {
-            parameter: "productionCost",
+            parameterType: "cost",
             direction: "increase",
             magnitude: 0.1,
             reasoning: `${role} at ${(share * 100).toFixed(0)}% \u2014 no crowding pressure detected. Apply role-specific cost increase to simulate saturation.`
@@ -946,7 +1004,8 @@ var P7_NonSpecialistsSubsidiseSpecialists = {
           severity: 6,
           evidence: { poolName, poolSize, dominantRole, dominantShare },
           suggestedAction: {
-            parameter: "entryFee",
+            parameterType: "fee",
+            scope: { tags: ["entry"] },
             direction: "decrease",
             magnitude: 0.1,
             reasoning: `Pool "${poolName}" draining (${poolSize}) \u2014 ${dominantRole} at ${(dominantShare * 100).toFixed(0)}%. Too many specialists, not enough subsidising non-specialists. Lower entry fee to attract diverse participants.`
@@ -974,7 +1033,7 @@ var P8_RegulatorCannotFightDesign = {
           severity: 4,
           evidence: { dominantRole: dominantRole[0], share: dominantRole[1], avgSatisfaction },
           suggestedAction: {
-            parameter: "rewardRate",
+            parameterType: "reward",
             direction: "increase",
             magnitude: 0.1,
             reasoning: `Low satisfaction with ${dominantRole[0]} dominant. Regulator may be suppressing a structurally necessary role. Ease pressure on dominant role rewards.`
@@ -1009,7 +1068,7 @@ var P9_RoleSwitchingNeedsFriction = {
         severity: 5,
         evidence: { totalChurnRate: totalChurn, churnByRole },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: "increase",
           magnitude: 0.05,
           reasoning: `Role switch rate ${(totalChurn * 100).toFixed(1)}% exceeds friction threshold. Increase production costs to slow herd movement.`
@@ -1024,9 +1083,9 @@ var P9_RoleSwitchingNeedsFriction = {
 };
 var P10_SpawnWeightingUsesInversePopulation = {
   id: "P10",
-  name: "Spawn Weighting Uses Inverse Population",
+  name: "Entry Weighting Uses Inverse Population",
   category: "population",
-  description: "New agents should preferentially fill the least-populated roles. Flat entry probability causes initial imbalances to compound.",
+  description: "New entrants should preferentially fill the least-populated roles. Flat entry probability causes initial imbalances to compound.",
   check(metrics, _thresholds) {
     const { roleShares } = metrics;
     if (Object.keys(roleShares).length === 0) return { violated: false };
@@ -1041,7 +1100,7 @@ var P10_SpawnWeightingUsesInversePopulation = {
         severity: 4,
         evidence: { roleShares, stdDev, leastPopulatedRole: minRole?.[0] },
         suggestedAction: {
-          parameter: "yieldRate",
+          parameterType: "yield",
           direction: "increase",
           magnitude: 0.05,
           reasoning: `High role share variance (\u03C3=${stdDev.toFixed(2)}). Entry weighting may not be filling under-populated roles. Increasing yield makes under-populated producer roles more attractive.`
@@ -1067,7 +1126,8 @@ var P11_TwoTierPressure = {
           severity: 6,
           evidence: { role, share },
           suggestedAction: {
-            parameter: "transactionFee",
+            parameterType: "fee",
+            scope: { tags: ["transaction"] },
             direction: "increase",
             magnitude: 0.15,
             reasoning: `${role} at ${(share * 100).toFixed(0)}% \u2014 continuous pressure was insufficient. Hard intervention needed alongside resumed continuous pressure.`
@@ -1095,7 +1155,7 @@ var P46_PersonaDiversity = {
           severity: 5,
           evidence: { dominantPersona: persona, share, personaDistribution },
           suggestedAction: {
-            parameter: "rewardRate",
+            parameterType: "reward",
             direction: "increase",
             magnitude: 0.1,
             reasoning: `${persona} persona at ${(share * 100).toFixed(0)}% \u2014 behavioral monoculture. Diversify reward structures to attract other persona types.`
@@ -1112,7 +1172,8 @@ var P46_PersonaDiversity = {
         severity: 3,
         evidence: { significantClusters, required: thresholds.personaMinClusters },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "decrease",
           magnitude: 0.05,
           reasoning: `Only ${significantClusters} significant persona clusters (need ${thresholds.personaMinClusters}). Lower trade barriers to attract non-dominant persona types.`
@@ -1136,7 +1197,7 @@ var P12_OnePrimaryFaucet = {
   id: "P12",
   name: "One Primary Faucet",
   category: "currency",
-  description: "Multiple independent currency sources (gathering + production + quests) each creating currency causes uncontrolled inflation. One clear primary faucet makes the economy predictable and auditable.",
+  description: "Multiple independent currency sources (gathering + production + activities) each creating currency causes uncontrolled inflation. One clear primary faucet makes the economy predictable and auditable.",
   check(metrics, thresholds) {
     for (const curr of metrics.currencies) {
       const netFlow = metrics.netFlowByCurrency[curr] ?? 0;
@@ -1148,9 +1209,9 @@ var P12_OnePrimaryFaucet = {
           severity: 5,
           evidence: { currency: curr, netFlow, faucetVolume, sinkVolume },
           suggestedAction: {
-            parameter: "productionCost",
+            parameterType: "cost",
             direction: "increase",
-            currency: curr,
+            scope: { currency: curr },
             magnitude: 0.15,
             reasoning: `[${curr}] Net flow +${netFlow.toFixed(1)}/tick. Inflationary. Increase production cost (primary sink) to balance faucet output.`
           },
@@ -1164,9 +1225,9 @@ var P12_OnePrimaryFaucet = {
           severity: 4,
           evidence: { currency: curr, netFlow, faucetVolume, sinkVolume },
           suggestedAction: {
-            parameter: "productionCost",
+            parameterType: "cost",
             direction: "decrease",
-            currency: curr,
+            scope: { currency: curr },
             magnitude: 0.15,
             reasoning: `[${curr}] Net flow ${netFlow.toFixed(1)}/tick. Deflationary. Decrease production cost to ease sink pressure.`
           },
@@ -1198,9 +1259,9 @@ var P13_PotsAreZeroSumAndSelfRegulate = {
             severity: 7,
             evidence: { currency: curr, pool: poolName, poolSize, participants: dominantCount, maxSustainableMultiplier },
             suggestedAction: {
-              parameter: "rewardRate",
+              parameterType: "reward",
               direction: "decrease",
-              currency: curr,
+              scope: { currency: curr },
               magnitude: 0.15,
               reasoning: `[${curr}] ${poolName} pool at ${poolSize.toFixed(0)} currency with ${dominantCount} active participants. Sustainable multiplier \u2264 ${maxSustainableMultiplier.toFixed(2)}. Reduce reward multiplier to prevent pool drain.`
             },
@@ -1217,7 +1278,7 @@ var P14_TrackActualInjection = {
   id: "P14",
   name: "Track Actual Currency Injection, Not Value Creation",
   category: "currency",
-  description: 'Counting resource gathering as "currency injected" is misleading. Currency enters through faucet mechanisms (spawning, rewards). Fake metrics break every downstream decision.',
+  description: 'Counting resource gathering as "currency injected" is misleading. Currency enters through faucet mechanisms (entering, rewards). Fake metrics break every downstream decision.',
   check(metrics, _thresholds) {
     for (const curr of metrics.currencies) {
       const faucetVolume = metrics.faucetVolumeByCurrency[curr] ?? 0;
@@ -1230,9 +1291,9 @@ var P14_TrackActualInjection = {
           severity: 4,
           evidence: { currency: curr, faucetVolume, netFlow, supplyGrowthRate },
           suggestedAction: {
-            parameter: "yieldRate",
+            parameterType: "yield",
             direction: "decrease",
-            currency: curr,
+            scope: { currency: curr },
             magnitude: 0.1,
             reasoning: `[${curr}] Supply growing at ${(supplyGrowthRate * 100).toFixed(1)}%/tick. Verify currency injection tracking. Resources should not create currency directly.`
           },
@@ -1262,9 +1323,9 @@ var P15_PoolsNeedCapAndDecay = {
             severity: 6,
             evidence: { currency: curr, pool, size, shareOfSupply, cap: poolCapPercent },
             suggestedAction: {
-              parameter: "transactionFee",
+              parameterType: "fee",
               direction: "decrease",
-              currency: curr,
+              scope: { tags: ["transaction"], currency: curr },
               magnitude: 0.1,
               reasoning: `[${curr}] ${pool} pool at ${(shareOfSupply * 100).toFixed(1)}% of supply (cap: ${(poolCapPercent * 100).toFixed(0)}%). Currency frozen. Lower fees to encourage circulation over accumulation.`
             },
@@ -1294,9 +1355,9 @@ var P16_WithdrawalPenaltyScales = {
             severity: 3,
             evidence: { currency: curr, pool: poolName, poolSize, estimatedStaked: stakedEstimate },
             suggestedAction: {
-              parameter: "transactionFee",
+              parameterType: "fee",
               direction: "increase",
-              currency: curr,
+              scope: { tags: ["transaction"], currency: curr },
               magnitude: 0.05,
               reasoning: `[${curr}] ${poolName} pool depleted while significant currency should be locked. Early withdrawals may be draining the pool. Ensure withdrawal penalty scales with lock duration.`
             },
@@ -1326,9 +1387,9 @@ var P32_VelocityAboveSupply = {
           severity: 4,
           evidence: { currency: curr, velocity, totalSupply, totalResources },
           suggestedAction: {
-            parameter: "transactionFee",
+            parameterType: "fee",
             direction: "decrease",
-            currency: curr,
+            scope: { tags: ["transaction"], currency: curr },
             magnitude: 0.2,
             reasoning: `[${curr}] Velocity ${velocity}/t with ${totalResources} resources in system. Economy stagnant despite available supply. Lower trading friction.`
           },
@@ -1368,9 +1429,9 @@ var P58_NoNaturalNumeraire = {
             meanPrice: mean
           },
           suggestedAction: {
-            parameter: "productionCost",
+            parameterType: "cost",
             direction: "increase",
-            currency: curr,
+            scope: { currency: curr },
             magnitude: 0.1,
             reasoning: `[${curr}] Price coefficient of variation ${coeffOfVariation.toFixed(2)} with velocity ${velocity.toFixed(1)}. All items priced similarly in an active economy \u2014 no natural num\xE9raire emerging. If a designated currency exists, increase its sink demand to differentiate it.`
           },
@@ -1405,7 +1466,8 @@ var P17_GracePeriodBeforeIntervention = {
         severity: 7,
         evidence: { tick: metrics.tick, avgSatisfaction: metrics.avgSatisfaction },
         suggestedAction: {
-          parameter: "entryFee",
+          parameterType: "fee",
+          scope: { tags: ["entry"] },
           direction: "decrease",
           magnitude: 0.2,
           reasoning: `Very low satisfaction at tick ${metrics.tick}. Intervention may have fired during grace period. Ease all costs to let economy bootstrap.`
@@ -1432,7 +1494,7 @@ var P18_FirstProducerNeedsStartingInventory = {
           severity: 8,
           evidence: { tick: metrics.tick, resource, supply, totalAgents: metrics.totalAgents },
           suggestedAction: {
-            parameter: "productionCost",
+            parameterType: "cost",
             direction: "decrease",
             magnitude: 0.5,
             reasoning: `Bootstrap failure: ${resource} supply is 0 at tick ${metrics.tick} with ${metrics.totalAgents} agents. Drastically reduce production cost to allow immediate output.`
@@ -1471,7 +1533,7 @@ var P19_StartingSupplyExceedsDemand = {
           resourcesPerAgent
         },
         suggestedAction: {
-          parameter: "rewardRate",
+          parameterType: "reward",
           direction: "increase",
           magnitude: 0.2,
           reasoning: `${mostPopulatedRole} (${population} agents) has insufficient resources (${resourcesPerAgent.toFixed(2)} per agent). Cold-start scarcity. Boost competitive pool reward to attract participation despite scarcity.`
@@ -1505,7 +1567,7 @@ var P20_DecayPreventsAccumulation = {
         severity: 4,
         evidence: { totalResources, resourcesPerAgent, velocity },
         suggestedAction: {
-          parameter: "yieldRate",
+          parameterType: "yield",
           direction: "decrease",
           magnitude: 0.1,
           reasoning: `${totalResources.toFixed(0)} resources with velocity ${velocity}/t. Likely hoarding. Reduce yield to increase scarcity and force circulation.`
@@ -1533,7 +1595,8 @@ var P21_PriceFromGlobalSupply = {
           severity: 3,
           evidence: { resource, volatility, supply, price: prices[resource] },
           suggestedAction: {
-            parameter: "transactionFee",
+            parameterType: "fee",
+            scope: { tags: ["transaction"] },
             direction: "increase",
             magnitude: 0.05,
             reasoning: `${resource} price volatile (${(volatility * 100).toFixed(0)}%) despite supply ${supply}. Price may not reflect global inventory. Increase trading friction to stabilise.`
@@ -1550,7 +1613,7 @@ var P22_MarketAwarenessPreventsSurplus = {
   id: "P22",
   name: "Market Awareness Prevents Overproduction",
   category: "feedback",
-  description: "Producers who craft without checking market prices will create surpluses that crash prices. Agents need to see prices before deciding to produce.",
+  description: "Producers who produce without checking market prices will create surpluses that crash prices. Agents need to see prices before deciding to produce.",
   check(metrics, _thresholds) {
     const { supplyByResource, prices, productionIndex } = metrics;
     const priceValues = Object.values(prices).filter((p) => p > 0);
@@ -1574,7 +1637,7 @@ var P22_MarketAwarenessPreventsSurplus = {
             productionIndex
           },
           suggestedAction: {
-            parameter: "productionCost",
+            parameterType: "cost",
             direction: "increase",
             magnitude: 0.1,
             reasoning: `${resource} price ${price.toFixed(0)} is ${(priceDeviation * 100).toFixed(0)}% of median (${medianPrice.toFixed(0)}). Supply ${supply} units but still producing. Producers appear unaware of market. Raise production cost to slow output.`
@@ -1601,7 +1664,7 @@ var P23_ProfitabilityFactorsFeasibility = {
         severity: 5,
         evidence: { blockedFraction, blockedAgentCount, avgSatisfaction },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: "decrease",
           magnitude: 0.15,
           reasoning: `${(blockedFraction * 100).toFixed(0)}% of agents blocked with low satisfaction. Agents may have roles they cannot afford to execute. Lower production costs to restore feasibility.`
@@ -1627,7 +1690,8 @@ var P24_BlockedAgentsDecayFaster = {
         severity: 5,
         evidence: { blockedFraction, blockedAgentCount, churnRate },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "decrease",
           magnitude: 0.15,
           reasoning: `${(blockedFraction * 100).toFixed(0)}% of agents blocked. Blocked agents churn silently, skewing metrics. Lower fees to unblock market participation.`
@@ -1672,7 +1736,7 @@ var P25_CorrectLeversForCorrectProblems = {
             netFlow
           },
           suggestedAction: {
-            parameter: "yieldRate",
+            parameterType: "yield",
             direction: "decrease",
             magnitude: 0.15,
             reasoning: `Inflation with ${resource} backlog (${supply} units, ${(supply / Math.max(1, avgSupply)).toFixed(1)}\xD7 average). Root cause is gathering. Correct lever: yieldRate, not fees.`
@@ -1698,7 +1762,7 @@ var P26_ContinuousPressureBeatsThresholdCuts = {
         severity: 4,
         evidence: { inflationRate },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: inflationRate > 0 ? "increase" : "decrease",
           magnitude: Math.min(thresholds.maxAdjustmentPercent, 0.05),
           // force smaller step
@@ -1724,7 +1788,8 @@ var P27_AdjustmentsNeedCooldowns = {
         severity: 4,
         evidence: { churnRate, avgSatisfaction },
         suggestedAction: {
-          parameter: "entryFee",
+          parameterType: "fee",
+          scope: { tags: ["entry"] },
           direction: "decrease",
           magnitude: 0.05,
           reasoning: `High churn (${(churnRate * 100).toFixed(1)}%) with low satisfaction. Possible oscillation from rapid adjustments. Apply small correction only.`
@@ -1755,7 +1820,7 @@ var P28_StructuralDominanceIsNotPathological = {
         severity: 5,
         evidence: { dominantRole, dominantShare, avgSatisfaction },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: "decrease",
           magnitude: 0.1,
           reasoning: `${dominantRole} dominant (${(dominantShare * 100).toFixed(0)}%) with low satisfaction. Pathological dominance \u2014 agents trapped, not thriving. Ease costs to allow role switching.`
@@ -1771,7 +1836,7 @@ var P38_CommunicationPreventsRevolt = {
   id: "P38",
   name: "Communication Prevents Revolt",
   category: "regulator",
-  description: "Every adjustment must be logged with reasoning. An adjustment made without explanation to players causes revolt. AgentE logs every decision \u2014 this principle checks that logging is active.",
+  description: "Every adjustment must be logged with reasoning. An adjustment made without explanation to participants causes revolt. AgentE logs every decision \u2014 this principle checks that logging is active.",
   check(metrics, _thresholds) {
     const { churnRate } = metrics;
     if (churnRate > 0.1) {
@@ -1780,7 +1845,7 @@ var P38_CommunicationPreventsRevolt = {
         severity: 3,
         evidence: { churnRate },
         suggestedAction: {
-          parameter: "rewardRate",
+          parameterType: "reward",
           direction: "increase",
           magnitude: 0.1,
           reasoning: `High churn (${(churnRate * 100).toFixed(1)}%) \u2014 agents leaving. Ensure all recent adjustments are logged with reasoning to diagnose cause.`
@@ -1803,7 +1868,7 @@ var REGULATOR_PRINCIPLES = [
 // src/principles/market-dynamics.ts
 var P29_PinchPoint = {
   id: "P29",
-  name: "Pinch Point",
+  name: "Bottleneck Detection",
   category: "market_dynamics",
   description: "Every economy has a resource that constrains all downstream activity. Identify which resource is the pinch point (consumers need them, producers make them). If demand drops \u2192 oversupply. If frustration rises \u2192 undersupply.",
   check(metrics, _thresholds) {
@@ -1817,7 +1882,7 @@ var P29_PinchPoint = {
           severity: 7,
           evidence: { resource, supply, demand, status },
           suggestedAction: {
-            parameter: "productionCost",
+            parameterType: "cost",
             direction: "decrease",
             magnitude: 0.15,
             reasoning: `${resource} is a pinch point and currently SCARCE (supply ${supply}, demand ${demand}). Reduce production cost to increase throughput.`
@@ -1833,7 +1898,7 @@ var P29_PinchPoint = {
           severity: 4,
           evidence: { resource, supply, status },
           suggestedAction: {
-            parameter: "productionCost",
+            parameterType: "cost",
             direction: "increase",
             magnitude: 0.1,
             reasoning: `${resource} is a pinch point and OVERSUPPLIED (supply ${supply}). Raise production cost to reduce surplus.`
@@ -1848,9 +1913,9 @@ var P29_PinchPoint = {
 };
 var P30_MovingPinchPoint = {
   id: "P30",
-  name: "Moving Pinch Point",
+  name: "Dynamic Bottleneck Rotation",
   category: "market_dynamics",
-  description: "Agent progression shifts the demand curve. A static pinch point that works early will be cleared later. The pinch point must move with agent progression to maintain ongoing scarcity and engagement.",
+  description: "Participant progression shifts the demand curve. A static pinch point that works early will be cleared later. The pinch point must move with participant progression to maintain ongoing scarcity and engagement.",
   check(metrics, _thresholds) {
     const { capacityUsage, supplyByResource, avgSatisfaction } = metrics;
     const totalResources = Object.values(supplyByResource).reduce((s, v) => s + v, 0);
@@ -1861,7 +1926,7 @@ var P30_MovingPinchPoint = {
         severity: 3,
         evidence: { capacityUsage, resourcesPerAgent, avgSatisfaction },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: "increase",
           magnitude: 0.1,
           reasoning: "Economy operating at full capacity with abundant resources and high satisfaction. Pinch point may have been cleared. Increase production cost to restore scarcity."
@@ -1877,7 +1942,7 @@ var P57_CombinatorialPriceSpace = {
   id: "P57",
   name: "Combinatorial Price Space",
   category: "market_dynamics",
-  description: "N tradeable items generate (N\u22121)N/2 relative prices. With thousands of items no single agent can track them all. Design for distributed self-organization, not centralized pricing.",
+  description: "N tradeable items generate (N\u22121)N/2 relative prices. With thousands of items no single participant can track them all. Design for distributed self-organization, not centralized pricing.",
   check(metrics, thresholds) {
     const { prices, priceVolatility } = metrics;
     const priceKeys = Object.keys(prices);
@@ -1907,7 +1972,8 @@ var P57_CombinatorialPriceSpace = {
           target: thresholds.relativePriceConvergenceTarget
         },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "decrease",
           magnitude: 0.1,
           reasoning: `Only ${(convergenceRate * 100).toFixed(0)}% of ${relativePriceCount} relative prices have converged (target: ${(thresholds.relativePriceConvergenceTarget * 100).toFixed(0)}%). Price space too complex for distributed discovery. Lower friction to help.`
@@ -1939,7 +2005,7 @@ var P31_AnchorValueTracking = {
         severity: 5,
         evidence: { anchorRatioDrift, inflationRate },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: anchorRatioDrift > 0 ? "increase" : "decrease",
           magnitude: 0.1,
           reasoning: `Anchor ratio has drifted ${(anchorRatioDrift * 100).toFixed(0)}% from baseline. Time-to-value for participants is changing. Adjust production costs to restore.`
@@ -1964,7 +2030,8 @@ var P41_MultiResolutionMonitoring = {
         severity: 4,
         evidence: { giniCoefficient, avgSatisfaction },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "increase",
           magnitude: 0.1,
           reasoning: `Gini ${giniCoefficient.toFixed(2)} rising despite okay satisfaction. Early warning from fine-resolution monitoring. Raise trading fees to slow wealth concentration before it hurts satisfaction.`
@@ -1993,7 +2060,8 @@ var P55_ArbitrageThermometer = {
           critical: thresholds.arbitrageIndexCritical
         },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "decrease",
           magnitude: 0.15,
           reasoning: `Arbitrage index ${arbitrageIndex.toFixed(2)} exceeds critical threshold (${thresholds.arbitrageIndexCritical}). Relative prices are diverging \u2014 economy destabilizing. Lower trading friction to accelerate price convergence.`
@@ -2011,7 +2079,8 @@ var P55_ArbitrageThermometer = {
           warning: thresholds.arbitrageIndexWarning
         },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "decrease",
           magnitude: 0.08,
           reasoning: `Arbitrage index ${arbitrageIndex.toFixed(2)} above warning threshold (${thresholds.arbitrageIndexWarning}). Early sign of price divergence. Gently reduce friction to support self-correction.`
@@ -2039,7 +2108,8 @@ var P59_GiftEconomyNoise = {
           threshold: thresholds.giftTradeFilterRatio
         },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "increase",
           magnitude: 0.05,
           reasoning: `${(giftTradeRatio * 100).toFixed(0)}% of trades are gift-like (price = 0 or <30% market). Exceeds filter threshold (${(thresholds.giftTradeFilterRatio * 100).toFixed(0)}%). Price signals contaminated. Slightly raise trading fees to discourage zero-value listings. ADVISORY: Consider filtering sub-market trades from price index computation.`
@@ -2082,9 +2152,9 @@ var P42_TheMedianPrinciple = {
             medianBalance
           },
           suggestedAction: {
-            parameter: "transactionFee",
+            parameterType: "fee",
+            scope: { tags: ["transaction"], currency: curr },
             direction: "increase",
-            currency: curr,
             magnitude: 0.15,
             reasoning: `[${curr}] Mean/median divergence ${(meanMedianDivergence * 100).toFixed(0)}% (threshold: ${(thresholds.meanMedianDivergenceMax * 100).toFixed(0)}%). Economy has outliers skewing metrics. Use median for decisions. Raise transaction fees to redistribute wealth.`
           },
@@ -2109,7 +2179,7 @@ var P43_SimulationMinimum = {
         severity: 3,
         evidence: { inflationRate, minIterations: thresholds.simulationMinIterations },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: inflationRate > 0 ? "increase" : "decrease",
           magnitude: 0.05,
           reasoning: `Large inflation rate swing (${(inflationRate * 100).toFixed(0)}%). Ensure all decisions use \u2265${thresholds.simulationMinIterations} simulation iterations. Apply conservative correction.`
@@ -2147,7 +2217,7 @@ var P39_TheLagPrinciple = {
         severity: 5,
         evidence: { inflationRate, netFlow, lagRange: [lagMin, lagMax] },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: "increase",
           magnitude: 0.03,
           // very small — oscillation means over-adjusting
@@ -2174,7 +2244,8 @@ var P44_ComplexityBudget = {
         severity: 3,
         evidence: { customMetricCount, budgetMax: thresholds.complexityBudgetMax },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "decrease",
           magnitude: 0.01,
           reasoning: `${customMetricCount} custom metrics tracked (budget: ${thresholds.complexityBudgetMax}). Consider pruning low-impact parameters. Applying minimal correction to avoid adding complexity.`
@@ -2206,7 +2277,8 @@ var P35_DestructionCreatesValue = {
           severity: 6,
           evidence: { resource, supply, sinkVolume, netFlow },
           suggestedAction: {
-            parameter: "entryFee",
+            parameterType: "fee",
+            scope: { tags: ["entry"] },
             direction: "decrease",
             magnitude: 0.1,
             reasoning: `${resource} supply at ${supply} units with low destruction (sink ${sinkVolume}/t). Resources not being consumed. Lower competitive pool entry to increase resource usage.`
@@ -2234,7 +2306,7 @@ var P40_ReplacementRate = {
           severity: 6,
           evidence: { productionIndex, sinkVolume, replacementRatio },
           suggestedAction: {
-            parameter: "yieldRate",
+            parameterType: "yield",
             direction: "increase",
             magnitude: 0.15,
             reasoning: `Replacement rate ${replacementRatio.toFixed(2)} (need \u2265${thresholds.replacementRateMultiplier}). Production below consumption. Resources will deplete. Increase yield.`
@@ -2248,7 +2320,7 @@ var P40_ReplacementRate = {
           severity: 3,
           evidence: { productionIndex, sinkVolume, replacementRatio },
           suggestedAction: {
-            parameter: "yieldRate",
+            parameterType: "yield",
             direction: "decrease",
             magnitude: 0.1,
             reasoning: `Replacement rate ${replacementRatio.toFixed(2)} \u2014 overproducing. Production far exceeds consumption. Reduce yield to prevent glut.`
@@ -2274,7 +2346,8 @@ var P49_IdleAssetTax = {
         severity: 5,
         evidence: { giniCoefficient, top10PctShare, velocity },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "increase",
           magnitude: 0.15,
           reasoning: `Gini ${giniCoefficient.toFixed(2)}, top 10% hold ${(top10PctShare * 100).toFixed(0)}%, velocity ${velocity}. Wealth concentrated in idle assets. Raise trading costs to simulate holding tax.`
@@ -2292,11 +2365,11 @@ var RESOURCE_MGMT_PRINCIPLES = [
   P49_IdleAssetTax
 ];
 
-// src/principles/player-experience.ts
+// src/principles/participant-experience.ts
 var P33_FairNotEqual = {
   id: "P33",
   name: "Fair \u2260 Equal",
-  category: "player_experience",
+  category: "participant_experience",
   description: "Gini = 0 is boring \u2014 everyone has the same and there is nothing to strive for. Healthy inequality from skill/effort is fine. Inequality from money (pay-to-win) is toxic. Target Gini 0.3-0.45: meaningful spread, not oligarchy.",
   check(metrics, thresholds) {
     for (const curr of metrics.currencies) {
@@ -2307,9 +2380,9 @@ var P33_FairNotEqual = {
           severity: 3,
           evidence: { currency: curr, giniCoefficient },
           suggestedAction: {
-            parameter: "rewardRate",
+            parameterType: "reward",
             direction: "increase",
-            currency: curr,
+            scope: { currency: curr },
             magnitude: 0.1,
             reasoning: `[${curr}] Gini ${giniCoefficient.toFixed(2)} \u2014 near-perfect equality. Economy lacks stakes. Increase winner rewards to create meaningful spread.`
           },
@@ -2323,9 +2396,9 @@ var P33_FairNotEqual = {
           severity: 7,
           evidence: { currency: curr, giniCoefficient },
           suggestedAction: {
-            parameter: "transactionFee",
+            parameterType: "fee",
             direction: "increase",
-            currency: curr,
+            scope: { tags: ["transaction"], currency: curr },
             magnitude: 0.2,
             reasoning: `[${curr}] Gini ${giniCoefficient.toFixed(2)} \u2014 oligarchy level. Toxic inequality. Raise transaction fees to redistribute wealth from rich to pool.`
           },
@@ -2339,9 +2412,9 @@ var P33_FairNotEqual = {
           severity: 4,
           evidence: { currency: curr, giniCoefficient },
           suggestedAction: {
-            parameter: "transactionFee",
+            parameterType: "fee",
             direction: "increase",
-            currency: curr,
+            scope: { tags: ["transaction"], currency: curr },
             magnitude: 0.1,
             reasoning: `[${curr}] Gini ${giniCoefficient.toFixed(2)} \u2014 high inequality warning. Gently raise fees to slow wealth concentration.`
           },
@@ -2355,9 +2428,9 @@ var P33_FairNotEqual = {
 };
 var P36_MechanicFrictionDetector = {
   id: "P36",
-  name: "Mechanic Friction Detector",
-  category: "player_experience",
-  description: "Deterministic + probabilistic systems \u2192 expectation mismatch. When crafting is guaranteed but combat is random, players feel betrayed by the random side. Mix mechanics carefully or segregate them entirely.",
+  name: "Mechanism Friction Detector",
+  category: "participant_experience",
+  description: "Deterministic + probabilistic systems \u2192 expectation mismatch. When production is guaranteed but competition is random, participants feel betrayed by the random side. Mix mechanisms carefully or segregate them entirely.",
   check(metrics, _thresholds) {
     const { avgSatisfaction, churnRate, velocity } = metrics;
     if (churnRate > 0.1 && avgSatisfaction < 50 && velocity > 3) {
@@ -2366,10 +2439,10 @@ var P36_MechanicFrictionDetector = {
         severity: 5,
         evidence: { churnRate, avgSatisfaction, velocity },
         suggestedAction: {
-          parameter: "rewardRate",
+          parameterType: "reward",
           direction: "increase",
           magnitude: 0.15,
-          reasoning: `Churn ${(churnRate * 100).toFixed(1)}% with satisfaction ${avgSatisfaction.toFixed(0)} despite active economy (velocity ` + velocity.toFixed(1) + "). Suggests mechanic friction (deterministic vs random systems). Increase rewards to compensate for perceived unfairness. ADVISORY: Review if mixing guaranteed and probabilistic mechanics."
+          reasoning: `Churn ${(churnRate * 100).toFixed(1)}% with satisfaction ${avgSatisfaction.toFixed(0)} despite active economy (velocity ` + velocity.toFixed(1) + "). Suggests mechanism friction (deterministic vs random systems). Increase rewards to compensate for perceived unfairness. ADVISORY: Review if mixing guaranteed and probabilistic mechanisms."
         },
         confidence: 0.55,
         estimatedLag: 15
@@ -2380,8 +2453,8 @@ var P36_MechanicFrictionDetector = {
 };
 var P37_LatecommerProblem = {
   id: "P37",
-  name: "Latecomer Problem",
-  category: "player_experience",
+  name: "Late Entrant Problem",
+  category: "participant_experience",
   description: "A new participant must reach viability in reasonable time. If all the good roles are saturated and prices are high, new agents cannot contribute and churn immediately.",
   check(metrics, _thresholds) {
     const { timeToValue, avgSatisfaction, churnRate } = metrics;
@@ -2391,7 +2464,7 @@ var P37_LatecommerProblem = {
         severity: 6,
         evidence: { timeToValue, avgSatisfaction, churnRate },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: "decrease",
           magnitude: 0.15,
           reasoning: `New agents taking ${timeToValue} ticks to reach viability. Churn ${(churnRate * 100).toFixed(1)}%, satisfaction ${avgSatisfaction.toFixed(0)}. Lower production costs to help new participants contribute faster.`
@@ -2406,7 +2479,7 @@ var P37_LatecommerProblem = {
 var P45_TimeBudget = {
   id: "P45",
   name: "Time Budget",
-  category: "player_experience",
+  category: "participant_experience",
   description: "required_time \u2264 available_time \xD7 0.8. If the economy requires more engagement than participants can realistically give, it is a disguised paywall. The 0.8 buffer accounts for real life.",
   check(metrics, thresholds) {
     const { timeToValue, avgSatisfaction } = metrics;
@@ -2418,8 +2491,9 @@ var P45_TimeBudget = {
         severity: 5,
         evidence: { timeToValue, avgSatisfaction, timeBudgetRatio: thresholds.timeBudgetRatio },
         suggestedAction: {
-          parameter: "entryFee",
+          parameterType: "fee",
           direction: "decrease",
+          scope: { tags: ["entry"] },
           magnitude: 0.15,
           reasoning: `Time-to-value ${timeToValue} ticks with ${avgSatisfaction.toFixed(0)} satisfaction. Economy requires too much time investment. Lower barriers to participation.`
         },
@@ -2433,7 +2507,7 @@ var P45_TimeBudget = {
 var P50_PayPowerRatio = {
   id: "P50",
   name: "Pay-Power Ratio",
-  category: "player_experience",
+  category: "participant_experience",
   description: "spender / non-spender power ratio > 2.0 = pay-to-win territory. Target 1.5 (meaningful advantage without shutting out non-payers). Above 2.0, non-paying participants start leaving.",
   check(metrics, thresholds) {
     const { top10PctShare, giniCoefficient } = metrics;
@@ -2448,8 +2522,9 @@ var P50_PayPowerRatio = {
           threshold: thresholds.payPowerRatioMax
         },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
           direction: "increase",
+          scope: { tags: ["transaction"] },
           magnitude: 0.2,
           reasoning: `Top 10% hold ${(top10PctShare * 100).toFixed(0)}% of wealth (Gini ${giniCoefficient.toFixed(2)}). Wealth advantage may exceed pay-power ratio threshold. Redistribute via higher trading fees.`
         },
@@ -2460,7 +2535,7 @@ var P50_PayPowerRatio = {
     return { violated: false };
   }
 };
-var PLAYER_EXPERIENCE_PRINCIPLES = [
+var PARTICIPANT_EXPERIENCE_PRINCIPLES = [
   P33_FairNotEqual,
   P36_MechanicFrictionDetector,
   P37_LatecommerProblem,
@@ -2483,7 +2558,8 @@ var P34_ExtractionRatio = {
         severity: 8,
         evidence: { extractionRatio, threshold: thresholds.extractionRatioRed },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "increase",
           magnitude: 0.25,
           reasoning: `Extraction ratio ${(extractionRatio * 100).toFixed(0)}% (critical: ${(thresholds.extractionRatioRed * 100).toFixed(0)}%). Economy is extraction-heavy and subsidy-dependent. Raise fees to increase the cost of extraction.`
@@ -2498,7 +2574,8 @@ var P34_ExtractionRatio = {
         severity: 5,
         evidence: { extractionRatio, threshold: thresholds.extractionRatioYellow },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "increase",
           magnitude: 0.1,
           reasoning: `Extraction ratio ${(extractionRatio * 100).toFixed(0)}% (warning: ${(thresholds.extractionRatioYellow * 100).toFixed(0)}%). Economy trending toward extraction-heavy. Apply early pressure.`
@@ -2524,7 +2601,7 @@ var P47_SmokeTest = {
         severity: 9,
         evidence: { smokeTestRatio, threshold: thresholds.smokeTestCritical },
         suggestedAction: {
-          parameter: "rewardRate",
+          parameterType: "reward",
           direction: "increase",
           magnitude: 0.2,
           reasoning: `Utility/market ratio ${(smokeTestRatio * 100).toFixed(0)}% (critical). Economy is >90% speculative. Collapse risk is extreme. Increase utility rewards to anchor real value.`
@@ -2539,7 +2616,7 @@ var P47_SmokeTest = {
         severity: 6,
         evidence: { smokeTestRatio, threshold: thresholds.smokeTestWarning },
         suggestedAction: {
-          parameter: "rewardRate",
+          parameterType: "reward",
           direction: "increase",
           magnitude: 0.1,
           reasoning: `Utility/market ratio ${(smokeTestRatio * 100).toFixed(0)}% (warning). Economy is >70% speculative. Boost utility rewards to restore intrinsic value anchor.`
@@ -2565,7 +2642,8 @@ var P48_CurrencyInsulation = {
         severity: 6,
         evidence: { currencyInsulation, threshold: thresholds.currencyInsulationMax },
         suggestedAction: {
-          parameter: "transactionFee",
+          parameterType: "fee",
+          scope: { tags: ["transaction"] },
           direction: "increase",
           magnitude: 0.1,
           reasoning: `Currency correlation with external market: ${(currencyInsulation * 100).toFixed(0)}% (max: ${(thresholds.currencyInsulationMax * 100).toFixed(0)}%). Economy is exposed to external market shocks. Increase internal friction to reduce external correlation.`
@@ -2583,12 +2661,12 @@ var OPEN_ECONOMY_PRINCIPLES = [
   P48_CurrencyInsulation
 ];
 
-// src/principles/liveops.ts
+// src/principles/operations.ts
 var P51_SharkTooth = {
   id: "P51",
-  name: "Shark Tooth Pattern",
-  category: "liveops",
-  description: "Each event peak should be \u226595% of the previous peak. If peaks are shrinking (shark tooth becoming flat), event fatigue is setting in. If valleys are deepening, the off-event economy is failing to sustain engagement.",
+  name: "Cyclical Engagement Pattern",
+  category: "operations",
+  description: "Each activity peak should be >=95% of the previous peak. If peaks are shrinking (cyclical engagement becoming flat), activity fatigue is setting in. If valleys are deepening, the off-activity economy is failing to sustain engagement.",
   check(metrics, thresholds) {
     const { sharkToothPeaks, sharkToothValleys } = metrics;
     if (sharkToothPeaks.length < 2) return { violated: false };
@@ -2605,10 +2683,10 @@ var P51_SharkTooth = {
           threshold: thresholds.sharkToothPeakDecay
         },
         suggestedAction: {
-          parameter: "rewardRate",
+          parameterType: "reward",
           direction: "increase",
           magnitude: 0.1,
-          reasoning: `Peak engagement dropped to ${(lastPeak / prevPeak * 100).toFixed(0)}% of previous peak (threshold: ${(thresholds.sharkToothPeakDecay * 100).toFixed(0)}%). Event fatigue detected. Boost event rewards to restore peak engagement.`
+          reasoning: `Peak engagement dropped to ${(lastPeak / prevPeak * 100).toFixed(0)}% of previous peak (threshold: ${(thresholds.sharkToothPeakDecay * 100).toFixed(0)}%). Activity fatigue detected. Boost activity rewards to restore peak engagement.`
         },
         confidence: 0.75,
         estimatedLag: 30
@@ -2623,10 +2701,10 @@ var P51_SharkTooth = {
           severity: 4,
           evidence: { lastValley, prevValley, ratio: lastValley / prevValley },
           suggestedAction: {
-            parameter: "productionCost",
+            parameterType: "cost",
             direction: "decrease",
             magnitude: 0.1,
-            reasoning: "Between-event engagement declining (deepening valleys). Base economy not sustaining participants between events. Lower production costs to improve off-event value."
+            reasoning: "Between-activity engagement declining (deepening valleys). Base economy not sustaining participants between activities. Lower production costs to improve off-activity value."
           },
           confidence: 0.65,
           estimatedLag: 20
@@ -2639,8 +2717,8 @@ var P51_SharkTooth = {
 var P52_EndowmentEffect = {
   id: "P52",
   name: "Endowment Effect",
-  category: "liveops",
-  description: "Participants who never owned premium items do not value them. Free trial events that let participants experience premium items drive conversions because ownership creates perceived value (endowment effect).",
+  category: "operations",
+  description: "Participants who never owned premium items do not value them. Free trial activities that let participants experience premium items drive conversions because ownership creates perceived value (endowment effect).",
   check(metrics, _thresholds) {
     const { avgSatisfaction, churnRate } = metrics;
     const { eventCompletionRate } = metrics;
@@ -2651,10 +2729,10 @@ var P52_EndowmentEffect = {
         severity: 4,
         evidence: { eventCompletionRate, avgSatisfaction, churnRate },
         suggestedAction: {
-          parameter: "rewardRate",
+          parameterType: "reward",
           direction: "increase",
           magnitude: 0.15,
-          reasoning: `${(eventCompletionRate * 100).toFixed(0)}% event completion but satisfaction only ${avgSatisfaction.toFixed(0)}. Events not creating perceived value. Increase reward quality/quantity.`
+          reasoning: `${(eventCompletionRate * 100).toFixed(0)}% activity completion but satisfaction only ${avgSatisfaction.toFixed(0)}. Activities not creating perceived value. Increase reward quality/quantity.`
         },
         confidence: 0.6,
         estimatedLag: 20
@@ -2665,8 +2743,8 @@ var P52_EndowmentEffect = {
 };
 var P53_EventCompletionRate = {
   id: "P53",
-  name: "Event Completion Rate Sweet Spot",
-  category: "liveops",
+  name: "Activity Completion Rate Sweet Spot",
+  category: "operations",
   description: "Free completion at 60-80% is the sweet spot. <40% = predatory design. >80% = no monetization pressure. 100% free = zero reason to ever spend.",
   check(metrics, thresholds) {
     const { eventCompletionRate } = metrics;
@@ -2681,10 +2759,10 @@ var P53_EventCompletionRate = {
           max: thresholds.eventCompletionMax
         },
         suggestedAction: {
-          parameter: "productionCost",
+          parameterType: "cost",
           direction: "decrease",
           magnitude: 0.15,
-          reasoning: `Event completion rate ${(eventCompletionRate * 100).toFixed(0)}% \u2014 predatory territory (min: ${(thresholds.eventCompletionMin * 100).toFixed(0)}%). Too hard for free participants. Lower barriers to participation.`
+          reasoning: `Activity completion rate ${(eventCompletionRate * 100).toFixed(0)}% \u2014 predatory territory (min: ${(thresholds.eventCompletionMin * 100).toFixed(0)}%). Too hard for free participants. Lower barriers to participation.`
         },
         confidence: 0.8,
         estimatedLag: 10
@@ -2696,10 +2774,11 @@ var P53_EventCompletionRate = {
         severity: 3,
         evidence: { eventCompletionRate, max: thresholds.eventCompletionMax },
         suggestedAction: {
-          parameter: "entryFee",
+          parameterType: "fee",
+          scope: { tags: ["entry"] },
           direction: "increase",
           magnitude: 0.05,
-          reasoning: `Event completion rate ${(eventCompletionRate * 100).toFixed(0)}% \u2014 no monetization pressure (max: ${(thresholds.eventCompletionMax * 100).toFixed(0)}%). Slightly raise costs to create meaningful premium differentiation.`
+          reasoning: `Activity completion rate ${(eventCompletionRate * 100).toFixed(0)}% \u2014 no monetization pressure (max: ${(thresholds.eventCompletionMax * 100).toFixed(0)}%). Slightly raise costs to create meaningful premium differentiation.`
         },
         confidence: 0.55,
         estimatedLag: 10
@@ -2710,9 +2789,9 @@ var P53_EventCompletionRate = {
 };
 var P54_LiveOpsCadence = {
   id: "P54",
-  name: "LiveOps Cadence",
-  category: "liveops",
-  description: ">50% of events that are re-wrapped existing content \u2192 staleness. The cadence must include genuinely new content at regular intervals. This is an advisory principle \u2014 AgentE can flag but cannot fix content.",
+  name: "Operational Cadence",
+  category: "operations",
+  description: ">50% of activities that are re-wrapped existing content \u2192 staleness. The cadence must include genuinely new content at regular intervals. This is an advisory principle \u2014 AgentE can flag but cannot fix content.",
   check(metrics, _thresholds) {
     const { velocity, avgSatisfaction } = metrics;
     if (velocity < 2 && avgSatisfaction < 55 && metrics.tick > 100) {
@@ -2721,7 +2800,7 @@ var P54_LiveOpsCadence = {
         severity: 3,
         evidence: { velocity, avgSatisfaction, tick: metrics.tick },
         suggestedAction: {
-          parameter: "rewardRate",
+          parameterType: "reward",
           direction: "increase",
           magnitude: 0.1,
           reasoning: "Low velocity and satisfaction after long runtime. Possible content staleness. Increase rewards as bridge while new content is developed (developer action required)."
@@ -2735,8 +2814,8 @@ var P54_LiveOpsCadence = {
 };
 var P56_ContentDropShock = {
   id: "P56",
-  name: "Content-Drop Shock",
-  category: "liveops",
+  name: "Supply Shock Absorption",
+  category: "operations",
   description: "Every new-item injection shatters existing price equilibria \u2014 arbitrage spikes as participants re-price. Build cooldown windows for price discovery before measuring post-drop economic health.",
   check(metrics, thresholds) {
     const { contentDropAge, arbitrageIndex } = metrics;
@@ -2752,7 +2831,8 @@ var P56_ContentDropShock = {
             postDropMax: thresholds.postDropArbitrageMax
           },
           suggestedAction: {
-            parameter: "transactionFee",
+            parameterType: "fee",
+            scope: { tags: ["transaction"] },
             direction: "decrease",
             magnitude: 0.1,
             reasoning: `Content drop ${contentDropAge} ticks ago \u2014 arbitrage at ${arbitrageIndex.toFixed(2)} exceeds post-drop max (${thresholds.postDropArbitrageMax}). Price discovery struggling. Lower trading friction temporarily.`
@@ -2765,7 +2845,7 @@ var P56_ContentDropShock = {
     return { violated: false };
   }
 };
-var LIVEOPS_PRINCIPLES = [
+var OPERATIONS_PRINCIPLES = [
   P51_SharkTooth,
   P52_EndowmentEffect,
   P53_EventCompletionRate,
@@ -2799,23 +2879,24 @@ var ALL_PRINCIPLES = [
   // P39, P44
   ...RESOURCE_MGMT_PRINCIPLES,
   // P35, P40, P49
-  ...PLAYER_EXPERIENCE_PRINCIPLES,
+  ...PARTICIPANT_EXPERIENCE_PRINCIPLES,
   // P33, P36, P37, P45, P50
   ...OPEN_ECONOMY_PRINCIPLES,
   // P34, P47-P48
-  ...LIVEOPS_PRINCIPLES
+  ...OPERATIONS_PRINCIPLES
   // P51-P54, P56
 ];
 
 // src/Simulator.ts
 var Simulator = class {
-  constructor() {
+  constructor(registry) {
     this.diagnoser = new Diagnoser(ALL_PRINCIPLES);
     // Cache beforeViolations for the *current* tick only (one entry max).
     // Using a Map here is intentional but the cache must be bounded — we only
     // care about the tick that is currently being evaluated, so we evict any
     // entries whose key differs from the incoming tick.
     this.beforeViolationsCache = /* @__PURE__ */ new Map();
+    this.registry = registry;
   }
   /**
    * Simulate the effect of applying `action` to the current economy forward `forwardTicks`.
@@ -2882,7 +2963,7 @@ var Simulator = class {
     const multiplier = this.actionMultiplier(action);
     const noise = () => 1 + (Math.random() - 0.5) * 0.1;
     const currencies = metrics.currencies;
-    const targetCurrency = action.currency;
+    const targetCurrency = action.scope?.currency;
     const supplies = { ...metrics.totalSupplyByCurrency };
     const netFlows = { ...metrics.netFlowByCurrency };
     const ginis = { ...metrics.giniCoefficientByCurrency };
@@ -2924,26 +3005,48 @@ var Simulator = class {
     return action.direction === "increase" ? 1 + base : 1 - base;
   }
   flowEffect(action, metrics, currency) {
-    const { parameter, direction } = action;
+    const { direction } = action;
     const sign = direction === "increase" ? -1 : 1;
     const roleEntries = Object.entries(metrics.populationByRole).sort((a, b) => b[1] - a[1]);
     const dominantRoleCount = roleEntries[0]?.[1] ?? 0;
-    if (parameter === "productionCost") {
-      return sign * (metrics.netFlowByCurrency[currency] ?? 0) * 0.2;
-    }
-    if (parameter === "transactionFee") {
-      return sign * (metrics.velocityByCurrency[currency] ?? 0) * 10 * 0.1;
-    }
-    if (parameter === "entryFee") {
-      return sign * dominantRoleCount * 0.5;
+    const resolvedKey = action.resolvedParameter;
+    let impact;
+    if (resolvedKey && this.registry) {
+      impact = this.registry.getFlowImpact(resolvedKey);
+    }
+    if (!impact) {
+      impact = this.inferFlowImpact(action.parameterType);
+    }
+    switch (impact) {
+      case "sink":
+        return sign * (metrics.netFlowByCurrency[currency] ?? 0) * 0.2;
+      case "faucet":
+        return -sign * dominantRoleCount * 0.3;
+      case "neutral":
+        return sign * dominantRoleCount * 0.5;
+      case "mixed":
+        return sign * (metrics.faucetVolumeByCurrency[currency] ?? 0) * 0.15;
+      default:
+        return sign * (metrics.netFlowByCurrency[currency] ?? 0) * 0.1;
+    }
+  }
+  /** Infer flow impact from parameter type when registry is unavailable */
+  inferFlowImpact(parameterType) {
+    switch (parameterType) {
+      case "cost":
+      case "fee":
+      case "penalty":
+        return "sink";
+      case "reward":
+        return "faucet";
+      case "yield":
+        return "mixed";
+      case "cap":
+      case "multiplier":
+        return "neutral";
+      default:
+        return "mixed";
     }
-    if (parameter === "rewardRate") {
-      return -sign * dominantRoleCount * 0.3;
-    }
-    if (parameter === "yieldRate") {
-      return sign * (metrics.faucetVolumeByCurrency[currency] ?? 0) * 0.15;
-    }
-    return sign * (metrics.netFlowByCurrency[currency] ?? 0) * 0.1;
   }
   checkImprovement(before, after, action) {
     const satisfactionImproved = after.avgSatisfaction >= before.avgSatisfaction - 2;
@@ -3023,16 +3126,30 @@ var Planner = class {
    * - parameter is still in cooldown
    * - simulation result failed
    * - complexity budget exceeded
+   * - no matching parameter in registry
    */
-  plan(diagnosis, metrics, simulationResult, currentParams, thresholds) {
+  plan(diagnosis, metrics, simulationResult, currentParams, thresholds, registry) {
     const action = diagnosis.violation.suggestedAction;
-    const param = action.parameter;
+    let param;
+    let resolvedBaseline;
+    let scope;
+    if (registry) {
+      const resolved = registry.resolve(action.parameterType, action.scope);
+      if (!resolved) return null;
+      param = resolved.key;
+      resolvedBaseline = resolved.currentValue;
+      scope = resolved.scope;
+      action.resolvedParameter = param;
+    } else {
+      param = action.resolvedParameter ?? action.parameterType;
+      scope = action.scope;
+    }
     if (this.lockedParams.has(param)) return null;
     if (this.isOnCooldown(param, metrics.tick, thresholds.cooldownTicks)) return null;
     if (!simulationResult.netImprovement) return null;
     if (!simulationResult.noNewProblems) return null;
     if (this.activePlanCount >= thresholds.complexityBudgetMax) return null;
-    const currentValue = currentParams[param] ?? 1;
+    const currentValue = resolvedBaseline ?? currentParams[param] ?? action.absoluteValue ?? 1;
     const magnitude = Math.min(action.magnitude ?? 0.1, thresholds.maxAdjustmentPercent);
     let targetValue;
     if (action.direction === "set" && action.absoluteValue !== void 0) {
@@ -3052,7 +3169,7 @@ var Planner = class {
       id: `plan_${metrics.tick}_${param}`,
       diagnosis,
       parameter: param,
-      ...action.currency !== void 0 ? { currency: action.currency } : {},
+      ...scope !== void 0 ? { scope } : {},
       currentValue,
       targetValue,
       maxChangePercent: thresholds.maxAdjustmentPercent,
@@ -3061,7 +3178,6 @@ var Planner = class {
         metric: "avgSatisfaction",
         direction: "below",
         threshold: Math.max(20, metrics.avgSatisfaction - 10),
-        // rollback if sat drops >10 pts
         checkAfterTick: metrics.tick + estimatedLag + 3
       },
       simulationResult,
@@ -3076,6 +3192,9 @@ var Planner = class {
   recordRolledBack(_plan) {
     this.activePlanCount = Math.max(0, this.activePlanCount - 1);
   }
+  recordSettled(_plan) {
+    this.activePlanCount = Math.max(0, this.activePlanCount - 1);
+  }
   isOnCooldown(param, currentTick, cooldownTicks) {
     const lastApplied = this.cooldowns.get(param);
     if (lastApplied === void 0) return false;
@@ -3094,40 +3213,54 @@ var Executor = class {
   }
   async apply(plan, adapter, currentParams) {
     const originalValue = currentParams[plan.parameter] ?? plan.currentValue;
-    await adapter.setParam(plan.parameter, plan.targetValue, plan.currency);
+    await adapter.setParam(plan.parameter, plan.targetValue, plan.scope);
     plan.appliedAt = plan.diagnosis.tick;
     this.activePlans.push({ plan, originalValue });
   }
   /**
    * Check all active plans for rollback conditions.
-   * Called every tick after metrics are computed.
-   * Returns list of plans that were rolled back.
+   * Returns { rolledBack, settled } — plans that were undone and plans that passed their window.
    */
   async checkRollbacks(metrics, adapter) {
     const rolledBack = [];
+    const settled = [];
     const remaining = [];
     for (const active of this.activePlans) {
       const { plan, originalValue } = active;
       const rc = plan.rollbackCondition;
+      const maxActiveTicks = 200;
+      if (plan.appliedAt !== void 0 && metrics.tick - plan.appliedAt > maxActiveTicks) {
+        settled.push(plan);
+        continue;
+      }
       if (metrics.tick < rc.checkAfterTick) {
         remaining.push(active);
         continue;
       }
       const metricValue = this.getMetricValue(metrics, rc.metric);
+      if (Number.isNaN(metricValue)) {
+        console.warn(
+          `[AgentE] Rollback check: metric path '${rc.metric}' resolved to NaN for plan '${plan.id}'. Triggering rollback as fail-safe.`
+        );
+        await adapter.setParam(plan.parameter, originalValue, plan.scope);
+        rolledBack.push(plan);
+        continue;
+      }
       const shouldRollback = rc.direction === "below" ? metricValue < rc.threshold : metricValue > rc.threshold;
       if (shouldRollback) {
-        await adapter.setParam(plan.parameter, originalValue, plan.currency);
+        await adapter.setParam(plan.parameter, originalValue, plan.scope);
         rolledBack.push(plan);
       } else {
         const settledTick = rc.checkAfterTick + 10;
         if (metrics.tick > settledTick) {
+          settled.push(plan);
         } else {
           remaining.push(active);
         }
       }
     }
     this.activePlans = remaining;
-    return rolledBack;
+    return { rolledBack, settled };
   }
   getMetricValue(metrics, metricPath) {
     const parts = metricPath.split(".");
@@ -3216,7 +3349,8 @@ var DecisionLog = class {
     return {
       id: `stub_${metrics.tick}`,
       diagnosis,
-      parameter: action.parameter,
+      parameter: action.resolvedParameter ?? action.parameterType,
+      ...action.scope !== void 0 ? { scope: action.scope } : {},
       currentValue: 1,
       targetValue: 1,
       maxChangePercent: 0,
@@ -3454,13 +3588,13 @@ var PersonaTracker = class {
       Earner: 0,
       Builder: 0,
       Social: 0,
-      Whale: 0,
+      HighValue: 0,
       Influencer: 0
     };
     let total = 0;
     for (const [, history] of this.agentHistory) {
       const persona = this.classify(history);
-      counts[persona]++;
+      counts[persona] = (counts[persona] ?? 0) + 1;
       total++;
     }
     if (total === 0) return {};
@@ -3480,7 +3614,7 @@ var PersonaTracker = class {
     const extraction = avg("netExtraction");
     const uniqueItems = avg("uniqueItemsHeld");
     const spend = avg("spendAmount");
-    if (spend > 1e3) return "Whale";
+    if (spend > 1e3) return "HighValue";
     if (txRate > 10) return "Trader";
     if (uniqueItems > 5 && extraction < 0) return "Collector";
     if (extraction > 100) return "Earner";
@@ -3489,12 +3623,116 @@ var PersonaTracker = class {
   }
 };
 
+// src/ParameterRegistry.ts
+var ParameterRegistry = class {
+  constructor() {
+    this.parameters = /* @__PURE__ */ new Map();
+  }
+  /** Register a parameter. Overwrites if key already exists. */
+  register(param) {
+    this.parameters.set(param.key, { ...param });
+  }
+  /** Register multiple parameters at once. */
+  registerAll(params) {
+    for (const p of params) this.register(p);
+  }
+  /**
+   * Resolve a parameterType + scope to a concrete RegisteredParameter.
+   * Returns the best match, or undefined if no match.
+   *
+   * Matching rules (in priority order):
+   * 1. Exact type match + all scope fields match
+   * 2. Exact type match + partial scope match (tags overlap)
+   * 3. Exact type match + no scope constraints
+   * 4. undefined (no match)
+   */
+  resolve(type, scope) {
+    const candidates = this.findByType(type);
+    if (candidates.length === 0) return void 0;
+    if (candidates.length === 1) return candidates[0];
+    let bestScore = -1;
+    let best;
+    for (const candidate of candidates) {
+      const score = this.scopeMatchScore(candidate.scope, scope);
+      if (score > bestScore) {
+        bestScore = score;
+        best = candidate;
+      }
+    }
+    return best;
+  }
+  /** Find all parameters of a given type. */
+  findByType(type) {
+    const results = [];
+    for (const param of this.parameters.values()) {
+      if (param.type === type) results.push(param);
+    }
+    return results;
+  }
+  /** Find all parameters belonging to a given system. */
+  findBySystem(system) {
+    const results = [];
+    for (const param of this.parameters.values()) {
+      if (param.scope?.system === system) results.push(param);
+    }
+    return results;
+  }
+  /** Get a parameter by its concrete key. */
+  get(key) {
+    return this.parameters.get(key);
+  }
+  /** Get the flow impact of a parameter by its concrete key. */
+  getFlowImpact(key) {
+    return this.parameters.get(key)?.flowImpact;
+  }
+  /** Update the current value of a registered parameter. */
+  updateValue(key, value) {
+    const param = this.parameters.get(key);
+    if (param) {
+      param.currentValue = value;
+    }
+  }
+  /** Get all registered parameters. */
+  getAll() {
+    return [...this.parameters.values()];
+  }
+  /** Number of registered parameters. */
+  get size() {
+    return this.parameters.size;
+  }
+  // ── Private ─────────────────────────────────────────────────────────────
+  scopeMatchScore(paramScope, queryScope) {
+    if (!queryScope) return 0;
+    if (!paramScope) return 0;
+    let score = 0;
+    if (queryScope.system && paramScope.system) {
+      if (queryScope.system === paramScope.system) score += 10;
+      else return -1;
+    }
+    if (queryScope.currency && paramScope.currency) {
+      if (queryScope.currency === paramScope.currency) score += 5;
+      else return -1;
+    }
+    if (queryScope.tags && queryScope.tags.length > 0 && paramScope.tags && paramScope.tags.length > 0) {
+      const overlap = queryScope.tags.filter((t) => paramScope.tags.includes(t)).length;
+      if (overlap > 0) {
+        score += overlap * 3;
+      } else {
+        return -1;
+      }
+    } else if (queryScope.tags && queryScope.tags.length > 0 && paramScope.tags && paramScope.tags.length > 0) {
+      return -1;
+    }
+    return score;
+  }
+};
+
 // src/AgentE.ts
 var AgentE = class {
   constructor(config) {
-    this.simulator = new Simulator();
     this.planner = new Planner();
     this.executor = new Executor();
+    this.registry = new ParameterRegistry();
     // ── State ──
     this.log = new DecisionLog();
     this.personaTracker = new PersonaTracker();
@@ -3519,7 +3757,8 @@ var AgentE = class {
       gracePeriod: config.gracePeriod ?? 50,
       checkInterval: config.checkInterval ?? 5,
       maxAdjustmentPercent: config.maxAdjustmentPercent ?? 0.15,
-      cooldownTicks: config.cooldownTicks ?? 15
+      cooldownTicks: config.cooldownTicks ?? 15,
+      parameters: config.parameters ?? []
     };
     this.thresholds = {
       ...DEFAULT_THRESHOLDS,
@@ -3531,6 +3770,10 @@ var AgentE = class {
     this.observer = new Observer(tickConfig);
     this.store = new MetricStore(tickConfig);
     this.diagnoser = new Diagnoser(ALL_PRINCIPLES);
+    if (config.parameters) {
+      this.registry.registerAll(config.parameters);
+    }
+    this.simulator = new Simulator(this.registry);
     if (config.onDecision) this.on("decision", config.onDecision);
     if (config.onAlert) this.on("alert", config.onAlert);
     if (config.onRollback) this.on("rollback", config.onRollback);
@@ -3568,15 +3811,24 @@ var AgentE = class {
     this.currentTick = currentState.tick;
     const events = [...this.eventBuffer];
     this.eventBuffer = [];
-    const metrics = this.observer.compute(currentState, events);
+    let metrics;
+    try {
+      metrics = this.observer.compute(currentState, events);
+    } catch (err) {
+      console.error(`[AgentE] Observer.compute() failed at tick ${currentState.tick}:`, err);
+      return;
+    }
     this.store.record(metrics);
     this.personaTracker.update(currentState);
     metrics.personaDistribution = this.personaTracker.getDistribution();
-    const rolledBack = await this.executor.checkRollbacks(metrics, this.adapter);
+    const { rolledBack, settled } = await this.executor.checkRollbacks(metrics, this.adapter);
     for (const plan2 of rolledBack) {
       this.planner.recordRolledBack(plan2);
       this.emit("rollback", plan2, "rollback condition triggered");
     }
+    for (const plan2 of settled) {
+      this.planner.recordSettled(plan2);
+    }
     if (metrics.tick < this.config.gracePeriod) return;
     if (metrics.tick % this.config.checkInterval !== 0) return;
     const diagnoses = this.diagnoser.diagnose(metrics, this.thresholds);
@@ -3598,7 +3850,8 @@ var AgentE = class {
       metrics,
       simulationResult,
       this.params,
-      this.thresholds
+      this.thresholds,
+      this.registry
     );
     if (!plan) {
       let reason = "skipped_cooldown";
@@ -3618,6 +3871,7 @@ var AgentE = class {
     }
     await this.executor.apply(plan, this.adapter, this.params);
     this.params[plan.parameter] = plan.targetValue;
+    this.registry.updateValue(plan.parameter, plan.targetValue);
     this.planner.recordApplied(plan, metrics.tick);
     const entry = this.log.record(topDiagnosis, plan, "applied", metrics);
     this.emit("decision", entry);
@@ -3627,6 +3881,7 @@ var AgentE = class {
   async apply(plan) {
     await this.executor.apply(plan, this.adapter, this.params);
     this.params[plan.parameter] = plan.targetValue;
+    this.registry.updateValue(plan.parameter, plan.targetValue);
     this.planner.recordApplied(plan, this.currentTick);
   }
   // ── Developer API ───────────────────────────────────────────────────────────
@@ -3651,6 +3906,12 @@ var AgentE = class {
   removePrinciple(id) {
     this.diagnoser.removePrinciple(id);
   }
+  registerParameter(param) {
+    this.registry.register(param);
+  }
+  getRegistry() {
+    return this.registry;
+  }
   registerCustomMetric(name, fn) {
     this.observer.registerCustomMetric(name, fn);
   }
@@ -4053,11 +4314,11 @@ function describeValue(value) {
   Executor,
   FEEDBACK_LOOP_PRINCIPLES,
   INCENTIVE_PRINCIPLES,
-  LIVEOPS_PRINCIPLES,
   MARKET_DYNAMICS_PRINCIPLES,
   MEASUREMENT_PRINCIPLES,
   MetricStore,
   OPEN_ECONOMY_PRINCIPLES,
+  OPERATIONS_PRINCIPLES,
   Observer,
   P10_SpawnWeightingUsesInversePopulation,
   P11_TwoTierPressure,
@@ -4119,9 +4380,10 @@ function describeValue(value) {
   P7_NonSpecialistsSubsidiseSpecialists,
   P8_RegulatorCannotFightDesign,
   P9_RoleSwitchingNeedsFriction,
+  PARTICIPANT_EXPERIENCE_PRINCIPLES,
   PERSONA_HEALTHY_RANGES,
-  PLAYER_EXPERIENCE_PRINCIPLES,
   POPULATION_PRINCIPLES,
+  ParameterRegistry,
   PersonaTracker,
   Planner,
   REGULATOR_PRINCIPLES,