@agent-e/core 1.4.4 → 1.5.1

package/dist/index.mjs

@@ -12,11 +12,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,
@@ -70,7 +70,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 = {
@@ -107,7 +107,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":
@@ -129,6 +129,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") {
+          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") {
+          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 = {};
@@ -338,7 +378,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;
       }
     }
@@ -415,6 +456,16 @@ var Observer = class {
       sharkToothValleys: this.previousMetrics?.sharkToothValleys ?? [],
       eventCompletionRate: NaN,
       contentDropAge,
+      systems: state.systems ?? [],
+      sources: state.sources ?? [],
+      sinks: state.sinks ?? [],
+      flowBySystem,
+      activityBySystem,
+      participantsBySystem,
+      flowBySource,
+      flowBySink,
+      sourceShare,
+      sinkShare,
       custom
     };
     this.previousMetrics = metrics;
@@ -557,6 +608,16 @@ function emptyMetrics(tick = 0) {
     sharkToothValleys: [],
     eventCompletionRate: NaN,
     contentDropAge: 0,
+    systems: [],
+    sources: [],
+    sinks: [],
+    flowBySystem: {},
+    activityBySystem: {},
+    participantsBySystem: {},
+    flowBySource: {},
+    flowBySink: {},
+    sourceShare: {},
+    sinkShare: {},
     custom: {}
   };
 }
@@ -589,7 +650,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."
@@ -623,7 +684,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."
@@ -653,7 +715,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."
@@ -672,7 +734,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);
@@ -685,7 +747,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."
@@ -700,7 +762,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."
@@ -728,7 +790,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.`
@@ -771,7 +833,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.`
@@ -797,7 +860,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.`
@@ -832,7 +895,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.`
@@ -860,7 +924,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.`
@@ -885,7 +949,7 @@ var P9_RoleSwitchingNeedsFriction = {
   id: "P9",
   name: "Role Switching Needs Friction",
   category: "population",
-  description: "If >5% of the population switches roles in a single evaluation period, it is a herd movement, not rational rebalancing. Without friction (satisfaction cost, cooldown), one good tick causes mass migration.",
+  description: "If >5% of the population switches roles in a single evaluation period, it is a herd movement, not rational rebalancing. Without friction (satisfaction cost, minimum interval), one good tick causes mass migration.",
   check(metrics, thresholds) {
     const { churnByRole, roleShares } = metrics;
     const totalChurn = Object.values(churnByRole).reduce((s, v) => s + v, 0);
@@ -895,7 +959,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.`
@@ -908,11 +972,11 @@ var P9_RoleSwitchingNeedsFriction = {
     return { violated: false };
   }
 };
-var P10_SpawnWeightingUsesInversePopulation = {
+var P10_EntryWeightingUsesInversePopulation = {
   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 };
@@ -927,7 +991,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.`
@@ -953,7 +1017,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.`
@@ -981,7 +1046,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.`
@@ -998,7 +1063,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.`
@@ -1012,7 +1078,7 @@ var P46_PersonaDiversity = {
 };
 var POPULATION_PRINCIPLES = [
   P9_RoleSwitchingNeedsFriction,
-  P10_SpawnWeightingUsesInversePopulation,
+  P10_EntryWeightingUsesInversePopulation,
   P11_TwoTierPressure,
   P46_PersonaDiversity
 ];
@@ -1022,7 +1088,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;
@@ -1034,9 +1100,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.`
           },
@@ -1050,9 +1116,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.`
           },
@@ -1084,9 +1150,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.`
             },
@@ -1103,7 +1169,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 extraction 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;
@@ -1116,9 +1182,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.`
           },
@@ -1148,9 +1214,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.`
             },
@@ -1180,9 +1246,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.`
             },
@@ -1212,9 +1278,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.`
           },
@@ -1254,9 +1320,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.`
           },
@@ -1291,7 +1357,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.`
@@ -1318,7 +1385,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.`
@@ -1357,7 +1424,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.`
@@ -1391,7 +1458,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.`
@@ -1419,7 +1486,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.`
@@ -1436,7 +1504,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);
@@ -1460,7 +1528,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.`
@@ -1487,7 +1555,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.`
@@ -1513,7 +1581,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.`
@@ -1558,7 +1627,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.`
@@ -1584,7 +1653,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
@@ -1610,7 +1679,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.`
@@ -1641,7 +1711,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.`
@@ -1657,7 +1727,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) {
@@ -1666,7 +1736,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.`
@@ -1687,9 +1757,9 @@ var REGULATOR_PRINCIPLES = [
 ];
 
 // src/principles/market-dynamics.ts
-var P29_PinchPoint = {
+var P29_BottleneckDetection = {
   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) {
@@ -1703,7 +1773,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.`
@@ -1719,7 +1789,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.`
@@ -1732,11 +1802,11 @@ var P29_PinchPoint = {
     return { violated: false };
   }
 };
-var P30_MovingPinchPoint = {
+var P30_DynamicBottleneckRotation = {
   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);
@@ -1747,7 +1817,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."
@@ -1763,7 +1833,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);
@@ -1793,7 +1863,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.`
@@ -1806,8 +1877,8 @@ var P57_CombinatorialPriceSpace = {
   }
 };
 var MARKET_DYNAMICS_PRINCIPLES = [
-  P29_PinchPoint,
-  P30_MovingPinchPoint,
+  P29_BottleneckDetection,
+  P30_DynamicBottleneckRotation,
   P57_CombinatorialPriceSpace
 ];
 
@@ -1825,7 +1896,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.`
@@ -1850,7 +1921,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.`
@@ -1879,7 +1951,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.`
@@ -1897,7 +1970,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.`
@@ -1925,7 +1999,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.`
@@ -1968,9 +2043,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.`
           },
@@ -1995,7 +2070,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.`
@@ -2033,7 +2108,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
@@ -2060,7 +2135,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.`
@@ -2092,7 +2168,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.`
@@ -2109,7 +2186,7 @@ var P40_ReplacementRate = {
   id: "P40",
   name: "Replacement Rate \u2265 2\xD7 Consumption",
   category: "resource",
-  description: "Respawn/production rate must be at least 2\xD7 consumption rate for equilibrium. At 1\xD7 you drift toward depletion. At 2\xD7 you have a buffer for demand spikes.",
+  description: "Replacement/production rate must be at least 2\xD7 consumption rate for equilibrium. At 1\xD7 you drift toward depletion. At 2\xD7 you have a buffer for demand spikes.",
   check(metrics, thresholds) {
     const { productionIndex, sinkVolume } = metrics;
     if (sinkVolume > 0 && productionIndex > 0) {
@@ -2120,7 +2197,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.`
@@ -2134,7 +2211,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.`
@@ -2160,7 +2237,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.`
@@ -2178,11 +2256,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) {
@@ -2193,9 +2271,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.`
           },
@@ -2209,9 +2287,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.`
           },
@@ -2225,9 +2303,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.`
           },
@@ -2241,9 +2319,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) {
@@ -2252,10 +2330,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
@@ -2266,8 +2344,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;
@@ -2277,7 +2355,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.`
@@ -2292,7 +2370,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;
@@ -2304,8 +2382,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.`
         },
@@ -2319,7 +2398,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;
@@ -2334,8 +2413,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.`
         },
@@ -2346,7 +2426,7 @@ var P50_PayPowerRatio = {
     return { violated: false };
   }
 };
-var PLAYER_EXPERIENCE_PRINCIPLES = [
+var PARTICIPANT_EXPERIENCE_PRINCIPLES = [
   P33_FairNotEqual,
   P36_MechanicFrictionDetector,
   P37_LatecommerProblem,
@@ -2369,7 +2449,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.`
@@ -2384,7 +2465,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.`
@@ -2410,7 +2492,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.`
@@ -2425,7 +2507,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.`
@@ -2451,7 +2533,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.`
@@ -2469,12 +2552,12 @@ var OPEN_ECONOMY_PRINCIPLES = [
   P48_CurrencyInsulation
 ];
 
-// src/principles/liveops.ts
-var P51_SharkTooth = {
+// src/principles/operations.ts
+var P51_CyclicalEngagement = {
   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 };
@@ -2491,10 +2574,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
@@ -2509,10 +2592,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
@@ -2525,8 +2608,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 assets do not value them. Free trial activities that let participants experience premium assets drive conversions because ownership creates perceived value (endowment effect).",
   check(metrics, _thresholds) {
     const { avgSatisfaction, churnRate } = metrics;
     const { eventCompletionRate } = metrics;
@@ -2537,10 +2620,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
@@ -2551,8 +2634,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;
@@ -2567,10 +2650,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
@@ -2582,10 +2665,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
@@ -2594,11 +2678,11 @@ var P53_EventCompletionRate = {
     return { violated: false };
   }
 };
-var P54_LiveOpsCadence = {
+var P54_OperationalCadence = {
   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 supply \u2192 stagnation. The cadence must include genuinely new supply at regular intervals. This is an advisory principle \u2014 AgentE can flag but cannot fix supply.",
   check(metrics, _thresholds) {
     const { velocity, avgSatisfaction } = metrics;
     if (velocity < 2 && avgSatisfaction < 55 && metrics.tick > 100) {
@@ -2607,10 +2691,10 @@ 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)."
+          reasoning: "Low velocity and satisfaction after long runtime. Possible supply stagnation. Increase rewards as bridge while new supply is developed (developer action required)."
         },
         confidence: 0.4,
         estimatedLag: 30
@@ -2619,11 +2703,11 @@ var P54_LiveOpsCadence = {
     return { violated: false };
   }
 };
-var P56_ContentDropShock = {
+var P56_SupplyShockAbsorption = {
   id: "P56",
-  name: "Content-Drop Shock",
-  category: "liveops",
-  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.",
+  name: "Supply Shock Absorption",
+  category: "operations",
+  description: "Every new-item injection shatters existing price equilibria \u2014 arbitrage spikes as participants re-price. Build stabilization windows for price discovery before measuring post-injection economic health.",
   check(metrics, thresholds) {
     const { contentDropAge, arbitrageIndex } = metrics;
     if (contentDropAge > 0 && contentDropAge <= thresholds.contentDropCooldownTicks) {
@@ -2638,10 +2722,11 @@ 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.`
+            reasoning: `Supply injection ${contentDropAge} ticks ago \u2014 arbitrage at ${arbitrageIndex.toFixed(2)} exceeds post-injection max (${thresholds.postDropArbitrageMax}). Price discovery struggling. Lower trading friction temporarily.`
           },
           confidence: 0.6,
           estimatedLag: 5
@@ -2651,12 +2736,12 @@ var P56_ContentDropShock = {
     return { violated: false };
   }
 };
-var LIVEOPS_PRINCIPLES = [
-  P51_SharkTooth,
+var OPERATIONS_PRINCIPLES = [
+  P51_CyclicalEngagement,
   P52_EndowmentEffect,
   P53_EventCompletionRate,
-  P54_LiveOpsCadence,
-  P56_ContentDropShock
+  P54_OperationalCadence,
+  P56_SupplyShockAbsorption
 ];
 
 // src/principles/index.ts
@@ -2685,23 +2770,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`.
@@ -2768,7 +2854,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 };
@@ -2810,26 +2896,54 @@ 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;
-    }
-    if (parameter === "rewardRate") {
-      return -sign * dominantRoleCount * 0.3;
+    let impact;
+    if (this.registry) {
+      const resolved = this.registry.resolve(action.parameterType, action.scope);
+      if (resolved) {
+        impact = resolved.flowImpact;
+      }
     }
-    if (parameter === "yieldRate") {
-      return sign * (metrics.faucetVolumeByCurrency[currency] ?? 0) * 0.15;
+    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;
+      case "friction":
+        return sign * (metrics.netFlowByCurrency[currency] ?? 0) * 0.1;
+      case "redistribution":
+        return sign * dominantRoleCount * 0.05;
+      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";
     }
-    return sign * (metrics.netFlowByCurrency[currency] ?? 0) * 0.1;
   }
   checkImprovement(before, after, action) {
     const satisfactionImproved = after.avgSatisfaction >= before.avgSatisfaction - 2;
@@ -2891,6 +3005,8 @@ var Planner = class {
     this.constraints = /* @__PURE__ */ new Map();
     this.cooldowns = /* @__PURE__ */ new Map();
     // param → last-applied-tick
+    this.typeCooldowns = /* @__PURE__ */ new Map();
+    // type+scope key → last-applied-tick
     this.activePlanCount = 0;
   }
   lock(param) {
@@ -2909,16 +3025,32 @@ 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;
+    const typeKey = this.typeCooldownKey(action.parameterType, action.scope);
+    if (this.isTypeCooldown(typeKey, metrics.tick, thresholds.cooldownTicks)) return null;
+    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) {
@@ -2938,7 +3070,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,
@@ -2947,7 +3079,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,
@@ -2957,11 +3088,17 @@ var Planner = class {
   }
   recordApplied(plan, tick) {
     this.cooldowns.set(plan.parameter, tick);
+    const action = plan.diagnosis.violation.suggestedAction;
+    const typeKey = this.typeCooldownKey(action.parameterType, action.scope);
+    this.typeCooldowns.set(typeKey, tick);
     this.activePlanCount++;
   }
   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;
@@ -2970,6 +3107,19 @@ var Planner = class {
   /** Reset all cooldowns (useful for testing) */
   resetCooldowns() {
     this.cooldowns.clear();
+    this.typeCooldowns.clear();
+  }
+  typeCooldownKey(type, scope) {
+    const parts = [type];
+    if (scope?.system) parts.push(`sys:${scope.system}`);
+    if (scope?.currency) parts.push(`cur:${scope.currency}`);
+    if (scope?.tags?.length) parts.push(`tags:${scope.tags.sort().join(",")}`);
+    return parts.join("|");
+  }
+  isTypeCooldown(typeKey, currentTick, cooldownTicks) {
+    const lastApplied = this.typeCooldowns.get(typeKey);
+    if (lastApplied === void 0) return false;
+    return currentTick - lastApplied < cooldownTicks;
   }
 };
 
@@ -2980,40 +3130,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(".");
@@ -3102,7 +3266,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,
@@ -3340,13 +3505,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 {};
@@ -3366,7 +3531,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";
@@ -3375,12 +3540,153 @@ 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:
+   * 1. Filter candidates by type
+   * 2. Score each by scope specificity (system +10, currency +5, tags +3 each)
+   * 3. Mismatched scope fields disqualify (score = -Infinity)
+   * 4. Ties broken by `priority` (higher wins), then registration order
+   * 5. All disqualified → undefined
+   */
+  resolve(type, scope) {
+    const candidates = this.findByType(type);
+    if (candidates.length === 0) return void 0;
+    if (candidates.length === 1) return candidates[0];
+    let bestScore = -Infinity;
+    let bestPriority = -Infinity;
+    let best;
+    for (const candidate of candidates) {
+      const score = this.scopeSpecificity(candidate.scope, scope);
+      const prio = candidate.priority ?? 0;
+      if (score > bestScore || score === bestScore && prio > bestPriority) {
+        bestScore = score;
+        bestPriority = prio;
+        best = candidate;
+      }
+    }
+    if (bestScore === -Infinity) return void 0;
+    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;
+  }
+  /**
+   * Validate the registry for common misconfigurations.
+   * Returns warnings (non-fatal) and errors (likely broken).
+   */
+  validate() {
+    const warnings = [];
+    const errors = [];
+    const typeMap = /* @__PURE__ */ new Map();
+    for (const param of this.parameters.values()) {
+      const list = typeMap.get(param.type) ?? [];
+      list.push(param);
+      typeMap.set(param.type, list);
+    }
+    for (const [type, params] of typeMap) {
+      if (params.length > 1) {
+        const unscopedCount = params.filter((p) => !p.scope).length;
+        if (unscopedCount > 1) {
+          errors.push(
+            `Type '${type}' has ${unscopedCount} unscoped parameters \u2014 resolve() cannot distinguish them`
+          );
+        }
+      }
+    }
+    for (const param of this.parameters.values()) {
+      if (!param.flowImpact) {
+        warnings.push(`Parameter '${param.key}' has no flowImpact \u2014 Simulator will use inference`);
+      }
+    }
+    return {
+      valid: errors.length === 0,
+      warnings,
+      errors
+    };
+  }
+  // ── Private ─────────────────────────────────────────────────────────────
+  scopeSpecificity(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 -Infinity;
+    }
+    if (queryScope.currency && paramScope.currency) {
+      if (queryScope.currency === paramScope.currency) score += 5;
+      else return -Infinity;
+    }
+    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 -Infinity;
+      }
+    }
+    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();
@@ -3401,11 +3707,13 @@ var AgentE = class {
       mode: this.mode,
       dominantRoles: config.dominantRoles ?? [],
       idealDistribution: config.idealDistribution ?? {},
+      validateRegistry: config.validateRegistry ?? true,
       tickConfig: config.tickConfig ?? { duration: 1, unit: "tick" },
       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,
@@ -3417,6 +3725,15 @@ 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);
+    }
+    if (config.validateRegistry !== false && this.registry.size > 0) {
+      const validation = this.registry.validate();
+      for (const w of validation.warnings) console.warn(`[AgentE] Registry warning: ${w}`);
+      for (const e of validation.errors) console.error(`[AgentE] Registry error: ${e}`);
+    }
+    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);
@@ -3454,15 +3771,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);
@@ -3484,7 +3810,8 @@ var AgentE = class {
       metrics,
       simulationResult,
       this.params,
-      this.thresholds
+      this.thresholds,
+      this.registry
     );
     if (!plan) {
       let reason = "skipped_cooldown";
@@ -3504,6 +3831,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);
@@ -3513,6 +3841,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 ───────────────────────────────────────────────────────────
@@ -3537,6 +3866,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);
   }
@@ -3594,6 +3929,31 @@ var AgentE = class {
   }
 };
 
+// src/utils.ts
+function findWorstSystem(metrics, check, tolerancePercent = 0) {
+  const systems = metrics.systems;
+  if (systems.length === 0) return void 0;
+  let worstSystem;
+  let worstScore = -Infinity;
+  let totalScore = 0;
+  for (const sys of systems) {
+    const score = check(sys, metrics);
+    totalScore += score;
+    if (score > worstScore) {
+      worstScore = score;
+      worstSystem = sys;
+    }
+  }
+  if (!worstSystem) return void 0;
+  if (tolerancePercent > 0 && systems.length > 1) {
+    const avg = totalScore / systems.length;
+    if (avg === 0) return { system: worstSystem, score: worstScore };
+    const excessPercent = (worstScore - avg) / Math.abs(avg) * 100;
+    if (excessPercent < tolerancePercent) return void 0;
+  }
+  return { system: worstSystem, score: worstScore };
+}
+
 // src/StateValidator.ts
 function validateEconomyState(state) {
   const errors = [];
@@ -3938,13 +4298,13 @@ export {
   Executor,
   FEEDBACK_LOOP_PRINCIPLES,
   INCENTIVE_PRINCIPLES,
-  LIVEOPS_PRINCIPLES,
   MARKET_DYNAMICS_PRINCIPLES,
   MEASUREMENT_PRINCIPLES,
   MetricStore,
   OPEN_ECONOMY_PRINCIPLES,
+  OPERATIONS_PRINCIPLES,
   Observer,
-  P10_SpawnWeightingUsesInversePopulation,
+  P10_EntryWeightingUsesInversePopulation,
   P11_TwoTierPressure,
   P12_OnePrimaryFaucet,
   P13_PotsAreZeroSumAndSelfRegulate,
@@ -3964,9 +4324,9 @@ export {
   P26_ContinuousPressureBeatsThresholdCuts,
   P27_AdjustmentsNeedCooldowns,
   P28_StructuralDominanceIsNotPathological,
-  P29_PinchPoint,
+  P29_BottleneckDetection,
   P2_ClosedLoopsNeedDirectHandoff,
-  P30_MovingPinchPoint,
+  P30_DynamicBottleneckRotation,
   P31_AnchorValueTracking,
   P32_VelocityAboveSupply,
   P33_FairNotEqual,
@@ -3989,12 +4349,12 @@ export {
   P49_IdleAssetTax,
   P4_MaterialsFlowFasterThanCooldown,
   P50_PayPowerRatio,
-  P51_SharkTooth,
+  P51_CyclicalEngagement,
   P52_EndowmentEffect,
   P53_EventCompletionRate,
-  P54_LiveOpsCadence,
+  P54_OperationalCadence,
   P55_ArbitrageThermometer,
-  P56_ContentDropShock,
+  P56_SupplyShockAbsorption,
   P57_CombinatorialPriceSpace,
   P58_NoNaturalNumeraire,
   P59_GiftEconomyNoise,
@@ -4004,9 +4364,10 @@ export {
   P7_NonSpecialistsSubsidiseSpecialists,
   P8_RegulatorCannotFightDesign,
   P9_RoleSwitchingNeedsFriction,
+  PARTICIPANT_EXPERIENCE_PRINCIPLES,
   PERSONA_HEALTHY_RANGES,
-  PLAYER_EXPERIENCE_PRINCIPLES,
   POPULATION_PRINCIPLES,
+  ParameterRegistry,
   PersonaTracker,
   Planner,
   REGULATOR_PRINCIPLES,
@@ -4016,6 +4377,7 @@ export {
   SYSTEM_DYNAMICS_PRINCIPLES,
   Simulator,
   emptyMetrics,
+  findWorstSystem,
   validateEconomyState
 };
 //# sourceMappingURL=index.mjs.map