Module:SouthernStraitCorridorOps: Difference between revisions

From MicrasWiki
Jump to navigationJump to search
← Older edit
NewZimiaGov (talk | contribs)
17,801 edits
No edit summary
NewZimiaGov (talk | contribs)
17,801 edits
No edit summary
 
(31 intermediate revisions by the same user not shown)
Line 1: Line 1:
-- Module:SouthernStraitCorridorOps
-- Module:SouthernStraitCorridorOps
-- Southern Strait-only daily operations wrapper.
-- CKD reinforcement at Nysara Velai and Selenarion
-- Shows only Haifan Bassaridian / Southern Strait entries from:
-- Post-agreement Southern Strait operations:
-- 1) WarLeagueDivisionOpsBVR
--   +6 percentage points to Nysara Velai Compliance Observed
-- 2) HatchMinistryDailyOps
--   -6 percentage points to Nysara Velai Rebellion Alert
-- 3) MissionaryDailyOpsBVR
--   historical trade sign-offs preserved through 27/3/53 PSSC
--
--   all future trade-agreement generation disabled from 28/3/53 PSSC onward
-- Also adds:
-- 4) Rare Southern Strait trade-agreement / General Port admission events
-- 5) Row-level locality focus column for extended Southern Strait,
--    Eastern Mykonos Desert, and eastern Snowholme foothill settlements
-- 6) Standalone locality / General Port status table
--
-- Current-date behavior:
-- If year/day are omitted, the module uses the current calculated PSSC date.
--
-- Economic design note:
-- Southern Strait and Eastern Mykonos localities are written as grounded
-- successor/satellite economies influenced by the historic port economies of
-- Blore Heath, Jogi, and Mylecia, without copying those ports directly.


local p = {}
local p = {}


--------------------------------------------------------------------------------
-- Helpers
-- Helpers
--------------------------------------------------------------------------------
local function yn(value, default)
local function yn(value, default)
local v = tostring(value or ""):lower()
local v = tostring(value or ""):lower()
Line 37: Line 20:
local function makeFrame(args)
local function makeFrame(args)
return { args = args or {} }
return { args = args or {} }
end
local function getCurrentPSSCDate()
local startDate = os.time({ year = 1999, month = 8, day = 6, hour = 0 })
local secondsInDay = 86400
local daysPerYear = 183
local currentDate = os.time()
local totalDaysElapsed = math.floor((currentDate - startDate) / secondsInDay)
local psscYear = math.floor(totalDaysElapsed / daysPerYear)
local dayOfYear = (totalDaysElapsed % daysPerYear) + 1
if dayOfYear < 1 then dayOfYear = 1 end
if dayOfYear > 183 then dayOfYear = 183 end
return psscYear, dayOfYear
end
local function normalizeArgsDate(args)
local out = {}
for k, v in pairs(args or {}) do
out[k] = v
end
local y = tonumber(out.year or out.psscyear)
local d = tonumber(out.day or out.dayofyear)
if not y or not d then
y, d = getCurrentPSSCDate()
end
out.year = tostring(y)
out.day = tostring(d)
out.psscyear = tostring(y)
out.dayofyear = tostring(d)
return out
end
end


Line 52: Line 67:
return false, "''" .. err .. ".''"
return false, "''" .. err .. ".''"
end
end
if type(mod[funcName]) ~= "function" then
if type(mod[funcName]) ~= "function" then
return false, "''" .. tostring(moduleName) .. " has no public function named " .. tostring(funcName) .. ".''"
return false, "''" .. tostring(moduleName) .. " has no public function named " .. tostring(funcName) .. ".''"
Line 60: Line 74:
return mod[funcName](makeFrame(args))
return mod[funcName](makeFrame(args))
end)
end)
if not ok then
if not ok then
return false, "''Error while invoking " .. tostring(moduleName) .. "." .. tostring(funcName) .. ": " .. tostring(result) .. "''"
return false, "''Error while invoking " .. tostring(moduleName) .. "." .. tostring(funcName) .. ": " .. tostring(result) .. "''"
end
end
return true, tostring(result or "")
return true, tostring(result or "")
end
local function getCurrentPSSCDate()
local startDate = os.time({year = 1999, month = 8, day = 6})
local secondsInDay = 86400
local daysPerYear = 183
local currentDate = os.time()
local totalDaysElapsed = math.floor((currentDate - startDate) / secondsInDay)
local yearFraction = totalDaysElapsed / daysPerYear
local psscYear = math.floor(yearFraction)
local dayOfYear = math.floor((yearFraction - psscYear) * daysPerYear) + 1
if dayOfYear < 1 then dayOfYear = 1 end
if dayOfYear > 183 then dayOfYear = 183 end
return psscYear, dayOfYear
end
local function resolveDate(args)
args = args or {}
local y = tonumber(args.year or args.psscyear)
local d = tonumber(args.day or args.dayofyear)
if y and d then
if d < 1 then d = 1 end
if d > 183 then d = 183 end
return y, d
end
return getCurrentPSSCDate()
end
end


Line 116: Line 95:


local function dateLabel(args)
local function dateLabel(args)
local y, d = resolveDate(args or {})
local y = tonumber(args.year or args.psscyear)
local m, dom = doyToMonthDom(d)
local d = tonumber(args.day or args.dayofyear)
return string.format("%d/%d/%d PSSC", dom, m, y)
if y and d then
local m, dom = doyToMonthDom(d)
return string.format("%d/%d/%d PSSC", dom, m, y)
end
return "current PSSC date"
end
end


Line 139: Line 122:
table.insert(out, '</div>')
table.insert(out, '</div>')
table.insert(out, '</div>')
table.insert(out, '</div>')
return table.concat(out, "\n")
return table.concat(out, "\n")
end
end
Line 166: Line 148:
end
end


local function flagLabel(file, label)
local function clampChance(value)
if file and tostring(file) ~= "" then
value = tonumber(value) or 0
return "{{flagicon image|" .. file .. "|200px}} " .. tostring(label or "")
if value < 0 then return 0 end
end
if value > 100 then return 100 end
return tostring(label or "")
return value
end
 
local function isOnOrAfterPSSCDate(year, day, startYear, startDay)
year = tonumber(year) or 0
day = tonumber(day) or 0
startYear = tonumber(startYear) or 0
startDay = tonumber(startDay) or 0
if year > startYear then return true end
if year == startYear and day >= startDay then return true end
return false
end
end


--------------------------------------------------------------------------------
-- Extended Southern Strait / Eastern Mykonos / Snowholme locality list
-- Extended Southern Strait / Eastern Mykonos / Snowholme locality list
--------------------------------------------------------------------------------
local southernTradeCities = {
local southernTradeCities = {
{
{
Line 185: Line 174:
company = "[[Mirovian Cistern Growers' Syndicate]]",
company = "[[Mirovian Cistern Growers' Syndicate]]",
resource = "cistern-grown melons, dryland cucumbers, preserved desert fruit, seed oil, packed caravan rations, and water-accounted produce consignments",
resource = "cistern-grown melons, dryland cucumbers, preserved desert fruit, seed oil, packed caravan rations, and water-accounted produce consignments",
terrain = "Oasis-edge desert town built around lined cisterns, wind-pumped wells, reflective irrigation basins, dry-route caravan stations, and water-accounted produce claims.",
role = "Serves as a desert provisioning point for caravan routes, ferry-market suppliers, road-transfer depots, inspection parties, and export-control checks operating between the Southern Strait and the interior desert routes.",
lineage = "Desert provisioning economy influenced by [[Jogi]]'s food-market role and [[Mylecia]]'s caravan-facing trade networks; adapted to cistern agriculture, water claims, and dry-route supply rather than beer, grain, or ritual crops"
lineage = "Desert provisioning economy influenced by [[Jogi]]'s food-market role and [[Mylecia]]'s caravan-facing trade networks; adapted to cistern agriculture, water claims, and dry-route supply rather than beer, grain, or ritual crops"
},
},
Line 196: Line 183:
company = "[[Saruq Thyrsa Reedcutters' Guild]]",
company = "[[Saruq Thyrsa Reedcutters' Guild]]",
resource = "coastal reed, cane fiber, packing straw, ferry mats, cargo-padding material, rope backing, warehouse thatch, and crate-lining bundles",
resource = "coastal reed, cane fiber, packing straw, ferry mats, cargo-padding material, rope backing, warehouse thatch, and crate-lining bundles",
terrain = "Brackish canal-edge and marsh-inlet settlement located near ferry shelters, reed beds, cargo landings, warehouse yards, and older coastal market routes.",
role = "Supplies practical harbor materials for ferry shelters, baskets, rope backing, cargo padding, crate linings, matting, and cheap construction; also serves as a frequent inspection point because reed, cane, and packing bundles can conceal documents, vouchers, courier packets, or small contraband.",
lineage = "Harbor-materials economy influenced by [[Blore Heath]]'s shipping brokerage and [[Jogi]]'s quay-market supply system; focused on practical cargo handling, ferry shelters, and packing materials rather than piracy or cult goods"
lineage = "Harbor-materials economy influenced by [[Blore Heath]]'s shipping brokerage and [[Jogi]]'s quay-market supply system; focused on practical cargo handling, ferry shelters, and packing materials rather than piracy or cult goods"
},
},
{
{
code = "AYS",
code = "AYS",
city = "[[Ayllu Nysara]]",
city = "[[Nysara Velai]]",
region = "Eastern foothills of the [[Snowholme Range]]",
region = "Eastern foothills of the [[Snowholme Range]]",
category = "Agriculture",
category = "Agriculture",
company = "[[Nysaran Terrace Farmers' Ayllu]]",
company = "[[Nysaran Terrace Farmers' Cooperative]]",
resource = "terrace beans, cold-weather tubers, sheep wool, highland fodder, pack-animal feed, preserved root stores, and mule-train provisions",
resource = "terrace beans, cold-weather tubers, sheep wool, highland fodder, pack-animal feed, preserved root stores, and mule-train provisions",
terrain = "Wechuan-influenced terrace settlement with shared irrigation channels, hillside fields, wool sheds, upland granaries, mule-train yards, and seasonal labor routes.",
role = "Links Snowholme foothill agriculture to Southern Strait supply routes, missionary kitchens, caravan stations, upland checkpoints, rail passengers, pack traffic, and food-storage networks.",
lineage = "Foothill supply economy influenced only indirectly by the Maritime Markets; tied more closely to Snowholme terrace farming, upland food storage, wool traffic, and pass-road provisioning"
lineage = "Foothill supply economy influenced only indirectly by the Maritime Markets; tied more closely to Snowholme terrace farming, upland food storage, wool traffic, and pass-road provisioning"
},
},
{
{
code = "THQ",
code = "THQ",
city = "[[Thal Qencha]]",
city = "[[Thal Lenaia]]",
region = "Eastern foothills of the [[Snowholme Range]]",
region = "Eastern foothills of the [[Snowholme Range]]",
category = "Agriculture",
category = "Agriculture",
company = "[[Thal Qencha Springkeepers' Cooperative]]",
company = "[[Thal Lenaia Springkeepers' Cooperative]]",
resource = "spring-fed watercress, trout ponds, smoked fish, cold-storage greens, inspected mountain food shipments, packed ice-box produce, and road-market fish consignments",
resource = "spring-fed watercress, trout ponds, smoked fish, cold-storage greens, inspected mountain food shipments, packed ice-box produce, and road-market fish consignments",
terrain = "Spring-fed foothill town centered on cold ponds, watercress beds, storage houses, smoking sheds, spring channels, road markets, and regulated food movement.",
role = "Functions as a water-rights, food-inspection, and cold-chain locality supporting pilgrims, traders, health lodges, caravan kitchens, storm-drainage work, mountain-road markets, and regulated food shipments.",
lineage = "Foothill water-and-food economy tied to Snowholme springs and pass roads; comparable to older Maritime Markets food distribution only in its role as a regulated supplier to travelers, markets, and route offices"
lineage = "Foothill water-and-food economy tied to Snowholme springs and pass roads; comparable to older Maritime Markets food distribution only in its role as a regulated supplier to travelers, markets, and route offices"
},
},
Line 229: Line 210:
company = "[[Rumi-Kefaya Stone and Lime Works]]",
company = "[[Rumi-Kefaya Stone and Lime Works]]",
resource = "basalt, limestone, paving stone, railway ballast, drainage tile, lime mortar, culvert blocks, harbor repair stone, quay coping, and storm-route masonry",
resource = "basalt, limestone, paving stone, railway ballast, drainage tile, lime mortar, culvert blocks, harbor repair stone, quay coping, and storm-route masonry",
terrain = "Quarry town on desert stone beds and dry road approaches, with steam-powered cutting yards, lime kilns, drainage works, culvert yards, and small tram or cartage links.",
role = "Provides practical construction material for roadbeds, rail sidings, harbor paving, culverts, retaining walls, inspection posts, shrine buildings, quay repairs, drainage routes, and storm-damaged corridor approaches.",
lineage = "Infrastructure economy influenced by [[Mylecia]]'s coal-and-works tradition and Southern Strait coastal preservation activity; focused on roads, quays, culverts, retaining walls, and storm-damage repair rather than extractive wealth"
lineage = "Infrastructure economy influenced by [[Mylecia]]'s coal-and-works tradition and Southern Strait coastal preservation activity; focused on roads, quays, culverts, retaining walls, and storm-damage repair rather than extractive wealth"
},
},
Line 240: Line 219:
company = "[[Hayr Chaskal Glass and Signal Works]]",
company = "[[Hayr Chaskal Glass and Signal Works]]",
resource = "beacon glass, telegraph insulators, lighthouse lenses, lamp glass, storm panes, signal mirrors, buoy lenses, and weatherproof signal housings",
resource = "beacon glass, telegraph insulators, lighthouse lenses, lamp glass, storm panes, signal mirrors, buoy lenses, and weatherproof signal housings",
terrain = "Signal-coast town with access to coastal sand, quartz, mica-bearing material, lighthouse workshops, telegraph maintenance yards, signal towers, and storm-warning stations.",
role = "Supports the communications and navigation side of the corridor posture, including ferry warnings, lighthouse maintenance, storm-delay routing, telegraph lines, Hatch Ministry watch posts, buoy repair, signal mirrors, and coastal inspection stations.",
lineage = "Signal-and-navigation economy influenced by [[Blore Heath]]'s shipping control and [[Mylecia]]'s coastal works; supports ferry warnings, lighthouse maintenance, telegraph lines, and Hatch Ministry watch posts without copying older pirate or brokerage firms"
lineage = "Signal-and-navigation economy influenced by [[Blore Heath]]'s shipping control and [[Mylecia]]'s coastal works; supports ferry warnings, lighthouse maintenance, telegraph lines, and Hatch Ministry watch posts without copying older pirate or brokerage firms"
},
},
{
{
code = "QSE",
code = "QSE",
city = "[[Qhapaq Selen]]",
city = "[[Selenarion]]",
region = "Eastern foothills of the [[Snowholme Range]]",
region = "Eastern foothills of the [[Snowholme Range]]",
category = "Services",
category = "Services",
company = "[[Qhapaq Selen Route Registry Office]]",
company = "[[Selenarion Route Registry Office]]",
resource = "night-road registry, caravan lodging, pass permits, route insurance, guide licensing, cargo-route papers, missing-traveler filings, and bonded transit records",
resource = "night-road registry, caravan lodging, pass permits, route insurance, guide licensing, cargo-route papers, missing-traveler filings, and bonded transit records",
terrain = "Foothill route town located along night-road approaches, caravan lodging lanes, pass offices, guide houses, bonded transit desks, and pilgrimage documentation offices.",
role = "Serves as the principal route-administration locality among the extended settlements, handling guide disputes, missing-traveler claims, forged pass papers, lodging records, Temple Bank documentation, caravan insurance, bonded transit files, and corridor movement records.",
lineage = "Foothill route-service economy influenced by [[Mylecia]]'s caravan-facing commerce and [[Jogi]]'s intelligence-and-paperwork traditions; adapted to Snowholme pass roads, guide houses, lodging records, and insurance claims"
lineage = "Foothill route-service economy influenced by [[Mylecia]]'s caravan-facing commerce and [[Jogi]]'s intelligence-and-paperwork traditions; adapted to Snowholme pass roads, guide houses, lodging records, and insurance claims"
}
}
}
}


--------------------------------------------------------------------------------
-- Locality presence controls
-- Row-level locality focus helper
-- In the CKD / War League section, AYS receives six rows and QSE receives two.
--------------------------------------------------------------------------------
-- Hatch Ministry and Temple Bank retain three AYS rows and one QSE row.
local cappedPresenceLocalities = {
MIR = true,
SAR = true,
THQ = true
}


local function rowLocality(args, channel, rowNumber)
local function findLocalityByCode(code)
if not southernTradeCities or #southernTradeCities == 0 then
code = tostring(code or "")
return "Southern Strait corridor"
for _, loc in ipairs(southernTradeCities or {}) do
if tostring(loc.code or "") == code then
return loc
end
end
end
return nil
end


local year, day = resolveDate(args or {})
local function localityCount(state, locOrCode)
local seed = tostring((args or {}).seed or "") .. ":SS-ROW-LOCALITY:" .. tostring(channel or "") .. ":" .. tostring(year) .. ":" .. tostring(day)
if not state or not state.counts then return 0 end
local code
if type(locOrCode) == "table" then
code = tostring(locOrCode.code or "")
else
code = tostring(locOrCode or "")
end
return tonumber(state.counts[code]) or 0
end
 
local function incrementLocalityCount(state, loc)
if not state or not loc then return end
local code = tostring(loc.code or "")
if code == "" then return end
state.counts[code] = (tonumber(state.counts[code]) or 0) + 1
end
 
local function nysaraVelaiPresenceTarget(args, channel)
local isWar = tostring(channel or "") == "war"
local v
if isWar then
v = tonumber(
args.warnysaravelaitarget or
args.warNysaraVelaiTarget or
args.warnysaratarget or
args.warNysaraTarget or
args.waraystarget or
args.warAysTarget
)
end
if v == nil then
v = tonumber(
args.nysaravelaitarget or
args.nysaraVelaiTarget or
args.nysaratarget or
args.nysaraTarget or
args.aystarget or
args.aysTarget
)
end
if v == nil then v = isWar and 6 or 3 end
if v < 0 then v = 0 end
return math.floor(v)
end
 
local function selenarionPresenceTarget(args, channel)
local isWar = tostring(channel or "") == "war"
local v
if isWar then
v = tonumber(
args.warselenariontarget or
args.warSelenarionTarget or
args.warqsetarget or
args.warQseTarget
)
end
if v == nil then
v = tonumber(
args.selenariontarget or
args.selenarionTarget or
args.qsetarget or
args.qseTarget
)
end
if v == nil then v = isWar and 2 or 1 end
if v < 0 then v = 0 end
return math.floor(v)
end
 
local function nysaraVelaiAllowOverTarget(args)
return yn(
args.nysaravelaioverfill or
args.nysaraVelaiOverfill or
args.nysaraoverfill or
args.nysaraOverfill or
args.aysoverfill or
args.aysOverfill,
false
)
end
 
local function buildPriorityLocalityPlan(args, channel)
local plan = {}
local nysaraTarget = nysaraVelaiPresenceTarget(args, channel)
local selenarionTarget = selenarionPresenceTarget(args, channel)
for _ = 1, nysaraTarget do table.insert(plan, "AYS") end
for _ = 1, selenarionTarget do table.insert(plan, "QSE") end
return plan
end
 
local function newLocalityAssignmentState(args, channel)
return {
channel = tostring(channel or ""),
counts = {},
aysTarget = nysaraVelaiPresenceTarget(args, channel),
aysAllowOverTarget = nysaraVelaiAllowOverTarget(args),
qseTarget = selenarionPresenceTarget(args, channel),
priorityPlan = buildPriorityLocalityPlan(args, channel)
}
end
 
local function canAssignLocality(args, loc, state)
if not loc then return false end
local code = tostring(loc.code or "")
if cappedPresenceLocalities[code] and localityCount(state, code) >= 1 then
return false
end
if code == "AYS" and state and not state.aysAllowOverTarget then
if localityCount(state, code) >= (tonumber(state.aysTarget) or 3) then
return false
end
end
if code == "QSE" and state then
if localityCount(state, code) >= (tonumber(state.qseTarget) or 1) then
return false
end
end
return true
end
 
local function priorityLocalityForRow(state, rowNumber)
if not state or not state.priorityPlan then return nil end
local row = tonumber(rowNumber) or 0
local code = state.priorityPlan[row]
if not code then return nil end
return findLocalityByCode(code)
end
 
local function rowLocalityData(args, channel, rowNumber, state)
if not southernTradeCities or #southernTradeCities == 0 then return nil end
state = state or newLocalityAssignmentState(args, channel)
 
local priorityLoc = priorityLocalityForRow(state, rowNumber)
if priorityLoc and canAssignLocality(args, priorityLoc, state) then
incrementLocalityCount(state, priorityLoc)
return priorityLoc
end
 
local year = tonumber(args.year or args.psscyear) or 0
local day = tonumber(args.day or args.dayofyear) or 0
local seed = tostring(args.seed or "") ..
":SS-ROW-LOCALITY:" .. tostring(channel or "") ..
":" .. tostring(year) ..
":" .. tostring(day)


local offset = hashString(seed) % #southernTradeCities
local offset = hashString(seed) % #southernTradeCities
local idx = ((tonumber(rowNumber) or 1) - 1 + offset) % #southernTradeCities + 1
local baseRow = tonumber(rowNumber) or 1
local loc = southernTradeCities[idx]
for attempt = 0, #southernTradeCities - 1 do
local idx = ((baseRow - 1 + offset + attempt) % #southernTradeCities) + 1
local loc = southernTradeCities[idx]
if canAssignLocality(args, loc, state) then
incrementLocalityCount(state, loc)
return loc
end
end
 
for _, loc in ipairs(southernTradeCities) do
local code = tostring(loc.code or "")
if not cappedPresenceLocalities[code] and code ~= "AYS" and code ~= "QSE" then
incrementLocalityCount(state, loc)
return loc
end
end
return nil
end


local function rowLocalityText(loc)
if not loc then return "Southern Strait corridor" end
return loc.city .. "<br><small>" .. loc.region .. "</small>"
return loc.city .. "<br><small>" .. loc.region .. "</small>"
end
end


local function addRowLocalities(body, args, channel)
-- Imperial Federation support marker and locality boosts
local IMPERIAL_SUPPORT_START_YEAR = 53
local IMPERIAL_SUPPORT_START_DAY = 112
local imperialFederationSupportLocalities = {
MIR = true,
SAR = true,
RUK = true
}
 
local function imperialSupportEnabled(args)
return yn(args.imperialsupport or args.imperialSupport or args.ifsupport or args.ifSupport, true)
end
 
local function imperialSupportEffective(args)
if not imperialSupportEnabled(args) then return false end
local year = tonumber(args.year or args.psscyear) or 0
local day = tonumber(args.day or args.dayofyear) or 0
local startYear = tonumber(args.imperialstartyear or args.imperialStartYear) or IMPERIAL_SUPPORT_START_YEAR
local startDay = tonumber(args.imperialstartday or args.imperialStartDay) or IMPERIAL_SUPPORT_START_DAY
return isOnOrAfterPSSCDate(year, day, startYear, startDay)
end
 
local function hasImperialFederationSupport(args, loc)
if not imperialSupportEffective(args) then return false end
return loc and imperialFederationSupportLocalities[tostring(loc.code or "")] == true
end
 
local function imperialSupportBoostedChance(args, loc, baseChance, boost)
local chance = clampChance(baseChance)
if hasImperialFederationSupport(args, loc) then
chance = chance + (tonumber(boost) or 0)
end
return clampChance(chance)
end
 
local function imperialFederationSupportNotice(args)
if not imperialSupportEffective(args) then return "" end
return "'''Imperial Federation support present:''' [[2nd Brigade, 25th Division of the Imperial Marines]] deployed in allied support of Bassaridian Southern Strait corridor activity around [[Saruq Thyrsa]], [[Mirovia]], and [[Rumi-Kefaya]].<br>" ..
"<small>Mechanized, mixed-capability support of approximately 4,000 soldiers reinforces route security, inspection cordons, convoy spacing, engineering liaison, and lawful corridor stabilization. " ..
"Locality rows for Saruq Thyrsa, Mirovia, and Rumi-Kefaya receive +10 percentage points to compliance observations. The former +3-point Temple Bank trade-signoff modifier remains relevant only when reproducing historical dates through 27/3/53 PSSC; all later trade-agreement generation is closed.</small>"
end
 
-- Bassaridian Missions support marker and locality adjustments
local BASSARIDIAN_MISSIONS_START_YEAR = 53
local BASSARIDIAN_MISSIONS_START_DAY = 116
local majorBassaridianMissionLocalities = {
SAR = true,
MIR = true,
AYS = true,
THQ = true,
QSE = true
}
 
local function bassaridianMissionsEnabled(args)
return yn(args.missionsupport or args.missionSupport or args.bassaridianmissions or args.bassaridianMissions, true)
end
 
local function bassaridianMissionsEffective(args)
if not bassaridianMissionsEnabled(args) then return false end
local year = tonumber(args.year or args.psscyear) or 0
local day = tonumber(args.day or args.dayofyear) or 0
local startYear = tonumber(args.missionstartyear or args.missionStartYear) or BASSARIDIAN_MISSIONS_START_YEAR
local startDay = tonumber(args.missionstartday or args.missionStartDay) or BASSARIDIAN_MISSIONS_START_DAY
return isOnOrAfterPSSCDate(year, day, startYear, startDay)
end
 
local function hasBassaridianMission(args, loc)
if not bassaridianMissionsEffective(args) then return false end
return loc ~= nil
end
 
local function hasMajorBassaridianMission(args, loc)
if not bassaridianMissionsEffective(args) then return false end
return loc and majorBassaridianMissionLocalities[tostring(loc.code or "")] == true
end
 
-- Nysara Velai-specific probability modifiers
local function nysaraVelaiComplianceBoost(args)
local v = tonumber(
args.nysaravelaicomplianceboost or
args.nysaraVelaiComplianceBoost or
args.nysaracomplianceboost or
args.nysaraComplianceBoost or
args.ayscomplianceboost or
args.aysComplianceBoost
)
if v == nil then v = 6 end
return v
end
 
local function nysaraVelaiUnrestAdjustment(args)
local reduction = tonumber(
args.nysaravelaiunrestreduction or
args.nysaraVelaiUnrestReduction or
args.nysaraunrestreduction or
args.nysaraUnrestReduction or
args.aysunrestreduction or
args.aysUnrestReduction
)
if reduction ~= nil then
return -math.abs(reduction)
end
 
-- Legacy additive override retained for compatibility.
local legacyBoost = tonumber(
args.nysaravelaiunrestboost or
args.nysaraVelaiUnrestBoost or
args.nysaraunrestboost or
args.nysaraUnrestBoost or
args.aysunrestboost or
args.aysUnrestBoost
)
if legacyBoost ~= nil then
return legacyBoost
end
return -6
end
 
local function nysaraVelaiTradeBoost(args)
local v = tonumber(
args.nysaravelaitradeboost or
args.nysaraVelaiTradeBoost or
args.nysaratradeboost or
args.nysaraTradeBoost or
args.aystradeboost or
args.aysTradeBoost
)
if v == nil then v = 3 end
return v
end
 
local function nysaraVelaiAdjustedComplianceChance(args, loc, baseChance)
local chance = clampChance(baseChance)
if loc and tostring(loc.code or "") == "AYS" then
chance = chance + nysaraVelaiComplianceBoost(args)
end
return clampChance(chance)
end
 
local function nysaraVelaiAdjustedUnrestChance(args, loc, baseChance)
local chance = clampChance(baseChance)
if loc and tostring(loc.code or "") == "AYS" then
chance = chance + nysaraVelaiUnrestAdjustment(args)
end
return clampChance(chance)
end
 
local function nysaraVelaiAdjustedTradeChance(args, loc, baseChance)
local chance = clampChance(baseChance)
if loc and tostring(loc.code or "") == "AYS" then
chance = chance + nysaraVelaiTradeBoost(args)
end
return clampChance(chance)
end
 
local function missionAdjustedComplianceChance(args, loc, baseChance)
local chance = clampChance(baseChance)
if hasBassaridianMission(args, loc) then
chance = chance + (tonumber(args.missioncomplianceboost or args.missionComplianceBoost) or 1)
end
if hasMajorBassaridianMission(args, loc) then
chance = chance + (tonumber(args.majormissioncomplianceboost or args.majorMissionComplianceBoost) or 2)
end
return clampChance(chance)
end
 
local function missionAdjustedUnrestChance(args, loc, baseChance)
local chance = clampChance(baseChance)
if hasBassaridianMission(args, loc) then
chance = chance - (tonumber(args.missionunrestreduction or args.missionUnrestReduction) or 1)
end
return clampChance(chance)
end
 
local function bassaridianMissionsNotice(args)
if not bassaridianMissionsEffective(args) then return "" end
return "'''Bassaridian Missions acknowledged:''' [[Temple Bank of the Reformed Stripping Path|Temple Bank]]-run fortified mission compounds operate across the Southern Strait locality system, with major mission houses at [[Saruq Thyrsa]], [[Mirovia]], [[Nysara Velai]], [[Thal Lenaia]], and [[Selenarion]].<br>" ..
"<small>From 55/2/53 PSSC onward, all locality rows receive -1 percentage point to unrest alerts and +1 percentage point to compliance observations. " ..
"Major mission localities receive an additional +2 percentage points to compliance observations. " ..
"Nysara Velai separately receives +6 percentage points to compliance-observation likelihood and -6 percentage points to unrest-alert likelihood, reflecting the stabilizing effect of the enlarged CKD presence, strengthened missionary institutions, protected terrace routes, and improving administrative cooperation across the eastern Snowholme approaches. Its former +3-point trade-signoff modifier is retained only for historical reproduction through 27/3/53 PSSC; no new agreements may be generated afterward. " ..
"Mission guards are drawn from local Baratar recruits and Council of Kings Division rotations, while deployed units continue to route through [[Mylecia]] before staging locally.</small>"
end
 
-- Recurring adversarial-node tracking
local ADVERSARY_NODES_START_YEAR = 53
local ADVERSARY_NODES_START_DAY = 121
 
local recurringAdversaries = {
KHADIR = {
name = "[[Khadir Veyran]]",
epithet = "Keeper of the Bromian Ledger",
localities = { QSE = true, AYS = true, RUK = true, HAY = true },
notes = {
"Bromian Ledger intermediaries are suspected of delaying countersignatures without openly refusing Bassaridian review.",
"Veyran-linked witnesses preserve older Maritime Markets custom as a rival source of commercial legitimacy.",
"Broker-house clerks appear to be keeping disputed cargo identity ambiguous until General Port auditors withdraw.",
"Warehouse notaries tied to the Bromian Ledger are suspected of turning routine paperwork into a jurisdictional dispute."
},
complianceNotes = {
"Temple Bank auditors noted that this cooperation weakens the Bromian Ledger's claim that older broker custom remains the only trusted record.",
"Local registry compliance was treated as useful evidence against Veyran-linked delay tactics.",
"The observation was preserved as a small but meaningful challenge to Bromian Ledger influence in the pass-road economy."
},
tradeNotes = {
"Temple Bank clerks flagged the sign-off as a possible counterweight to Khadir Veyran's older broker-credit network.",
"The filing gives General Port auditors a lawful route around Bromian Ledger intermediaries.",
"The agreement was preserved as evidence that local commercial authority could be recorded without Veyran's countersignature."
}
},
SUYANA = {
name = "[[Suyana Amaruq]]",
epithet = "Black-Thread Suyana",
localities = { QSE = true, AYS = true, THQ = true, HAY = true },
notes = {
"Black-Thread couriers are suspected of using ordinary household movement to mask route intelligence.",
"Suyana-linked runners may have tested night-road inspection gaps before disappearing into ordinary market traffic.",
"False pilgrims and guide-house messengers appear to have carried warning signals ahead of the audit lane.",
"Temple Bank officers treated the incident as route-intelligence obstruction rather than ordinary smuggling."
},
complianceNotes = {
"The observation was treated as a useful interruption of Black-Thread courier habits.",
"Licensed guides helped separate ordinary passage from Suyana-linked courier movement.",
"Temple Bank staff preserved the record as evidence that local mobility could be protected without unregistered courier screens."
},
tradeNotes = {
"Temple Bank notes warned that Black-Thread couriers may attempt to test the new trade window through false-route traffic.",
"The sign-off was paired with route-watch instructions because Suyana-linked couriers remained active near the upland approaches.",
"Mission clerks treated the filing as useful, but not sufficient to end Black-Thread influence over informal passage."
}
}
}
 
local function adversaryNodesEnabled(args)
return yn(
args.adversarynodes or
args.adversaryNodes or
args.namedadversaries or
args.namedAdversaries or
args.adversarynotes or
args.adversaryNotes,
true
)
end
 
local function adversaryNodesEffective(args)
if not adversaryNodesEnabled(args) then return false end
local year = tonumber(args.year or args.psscyear) or 0
local day = tonumber(args.day or args.dayofyear) or 0
local startYear = tonumber(args.adversarystartyear or args.adversaryStartYear) or ADVERSARY_NODES_START_YEAR
local startDay = tonumber(args.adversarystartday or args.adversaryStartDay) or ADVERSARY_NODES_START_DAY
return isOnOrAfterPSSCDate(year, day, startYear, startDay)
end
 
local function adversaryNoteChance(args, kind)
kind = tostring(kind or "")
if kind == "trade" then
return clampChance(tonumber(args.tradeadversarychance or args.tradeAdversaryChance) or 22)
elseif kind == "compliance" then
return clampChance(tonumber(args.complianceadversarychance or args.complianceAdversaryChance) or 18)
end
return clampChance(tonumber(
args.adversarychance or
args.adversaryChance or
args.unrestadversarychance or
args.unrestAdversaryChance
) or 35)
end
 
local function localityAllowsAdversary(loc, adv)
if not adv then return false end
if not loc then return true end
local localities = adv.localities
if not localities then return true end
return localities[tostring(loc.code or "")] == true
end
 
local function candidateAdversaryCodes(profile, loc)
local out = {}
if profile and type(profile.adversaries) == "table" then
for _, code in ipairs(profile.adversaries) do
local adv = recurringAdversaries[code]
if adv and localityAllowsAdversary(loc, adv) then
table.insert(out, code)
end
end
end
if #out == 0 then
for code, adv in pairs(recurringAdversaries) do
if localityAllowsAdversary(loc, adv) then
table.insert(out, code)
end
end
end
return out
end
 
local function adversaryNotePart(args, kind, seed, profile, loc)
if not adversaryNodesEffective(args) then return "" end
local chance = adversaryNoteChance(args, kind)
local roll = pctFromSeed(seed, "adv-note-roll-" .. tostring(kind or "general")) + 1
if roll > chance then return "" end
 
local candidates = candidateAdversaryCodes(profile, loc)
local code = pick(candidates, seed, "adv-note-code-" .. tostring(kind or "general"))
local adv = recurringAdversaries[code]
if not adv then return "" end
 
local notes = adv.notes
if tostring(kind or "") == "trade" and adv.tradeNotes then
notes = adv.tradeNotes
elseif tostring(kind or "") == "compliance" and adv.complianceNotes then
notes = adv.complianceNotes
end
 
local note = pick(notes, seed, "adv-note-text-" .. tostring(kind or "general"))
if not note then return "" end
return "<br>'''Adversarial note:''' " .. adv.name .. " (''" .. adv.epithet .. "'') — " .. note
end
 
local function adversarialNodesNotice(args)
if not adversaryNodesEffective(args) then return "" end
return "'''Temple Bank adversarial-node tracking active:''' from 60/2/53 PSSC onward, occasional row-level notes may identify suspected influence associated with [[Khadir Veyran]] (''Keeper of the Bromian Ledger'') or [[Suyana Amaruq]] (''Black-Thread Suyana'').<br>" ..
"<small>These notes are seeded and probabilistic. They do not appear in every unrest or compliance row; trade-signoff notes remain available only when reproducing historical dates through 27/3/53 PSSC. " ..
"Use '''adversarynodes=no''' to disable them, '''adversarychance=35''' to adjust unrest-note frequency, '''complianceadversarychance=18''' to adjust compliance-note frequency, and '''tradeadversarychance=22''' only for historical trade-signoff rows.</small>"
end
 
-- Forced City/Node display
local forcedCityNodeText = "[[File:MyleciaFlabB.jpeg|20px]] [[Mylecia]]"
 
local function cleanHeaderLabel(line)
local s = tostring(line or "")
s = s:gsub("^%s*!+%s*", "")
if s:find("|", 1, true) then
local parts = mw.text.split(s, "|", true)
s = parts[#parts] or s
end
s = s:gsub("<.->", "")
s = s:gsub("%[%[[^%]|]+|([^%]]+)%]%]", "%1")
s = s:gsub("%[%[([^%]]+)%]%]", "%1")
s = s:gsub("&nbsp;", " ")
s = s:gsub("%s*/%s*", "/")
s = s:gsub("^%s+", ""):gsub("%s+$", "")
return s:lower()
end
 
local cityNodeHeaderLabels = {
["city"] = true,
["node"] = true,
["city/node"] = true,
["city / node"] = true,
["city or node"] = true,
["home port"] = true,
["homeport"] = true,
["home city"] = true,
["base city"] = true,
["staging city"] = true
}
 
local function forceMyleciaCityNodeColumn(body, args)
body = tostring(body or "")
body = tostring(body or "")
if yn(args.forcemylecia or args.forceMylecia or args.myleciacity or args.myleciaCity, true) == false then
return body
end
if not body:find("{|", 1, true) then return body end
local forcedText = args.forcecitytext or args.forceCityText or forcedCityNodeText
local lines = mw.text.split(body, "\n", true)
local out = {}
local inTable = false
local cityCol = nil
local col = 0


if not body:find("{|", 1, true) then
for _, line in ipairs(lines) do
if line:match("^%s*{|") then
inTable = true
cityCol = nil
col = 0
table.insert(out, line)
elseif inTable and line:match("^%s*!") then
local raw = line:gsub("^%s*!+%s*", "")
local headers = mw.text.split(raw, "!!", true)
if #headers > 1 then
for _, h in ipairs(headers) do
col = col + 1
if cityNodeHeaderLabels[cleanHeaderLabel("! " .. h)] then
cityCol = col
end
end
else
col = col + 1
if cityNodeHeaderLabels[cleanHeaderLabel(line)] then
cityCol = col
end
end
table.insert(out, line)
elseif inTable and line:match("^%s*|%-") then
col = 0
table.insert(out, line)
elseif inTable and cityCol and line:match("^%s*|[^}%-%+]") then
local raw = line:gsub("^%s*|%s*", "")
local cells = mw.text.split(raw, "||", true)
if #cells > 1 then
for i = 1, #cells do
if i == cityCol then cells[i] = " " .. forcedText .. " " end
end
table.insert(out, "| " .. table.concat(cells, " || "))
else
col = col + 1
if col == cityCol then
table.insert(out, "| " .. forcedText)
else
table.insert(out, line)
end
end
elseif inTable and line:match("^%s*|}") then
inTable = false
table.insert(out, line)
else
table.insert(out, line)
end
end
return table.concat(out, "\n")
end
 
-- Hatch Ministry Home city / Current station swap
local function swapHatchHomeCityCurrentStation(body, args)
body = tostring(body or "")
if yn(args.swaphatchstation or args.swapHatchStation or args.swaphatchhomecity or args.swapHatchHomeCity, true) == false then
return body
return body
end
end
if not body:find("{|", 1, true) then return body end


local lines = mw.text.split(body, "\n", true)
local lines = mw.text.split(body, "\n", true)
local out = {}
local out = {}
local inTable = false
local inTable = false
local headerInserted = false
local homeCol = nil
local rowNumber = 0
local stationCol = nil
local col = 0


for _, line in ipairs(lines) do
for _, line in ipairs(lines) do
if line:match("^%s*{|") then
if line:match("^%s*{|") then
inTable = true
inTable = true
headerInserted = false
homeCol = nil
stationCol = nil
col = 0
table.insert(out, line)
table.insert(out, line)
 
elseif inTable and line:match("^%s*!") then
elseif inTable and not headerInserted and line:match("^%s*!") then
local raw = line:gsub("^%s*!+%s*", "")
table.insert(out, "! Locality focus")
local headers = mw.text.split(raw, "!!", true)
headerInserted = true
if #headers > 1 then
for _, h in ipairs(headers) do
col = col + 1
local label = cleanHeaderLabel("! " .. h)
if label == "home city" or label == "home" then
homeCol = col
elseif label == "current station" or label == "station" then
stationCol = col
end
end
else
col = col + 1
local label = cleanHeaderLabel(line)
if label == "home city" or label == "home" then
homeCol = col
elseif label == "current station" or label == "station" then
stationCol = col
end
end
table.insert(out, line)
table.insert(out, line)
elseif inTable and line:match("^%s*|%-") then
elseif inTable and line:match("^%s*|%-") then
rowNumber = rowNumber + 1
col = 0
table.insert(out, line)
table.insert(out, line)
table.insert(out, "| " .. rowLocality(args, channel, rowNumber))
elseif inTable and homeCol and stationCol and line:match("^%s*|[^}%-%+]") then
 
local raw = line:gsub("^%s*|%s*", "")
local cells = mw.text.split(raw, "||", true)
if #cells > 1 then
if cells[homeCol] and cells[stationCol] then
cells[homeCol], cells[stationCol] = cells[stationCol], cells[homeCol]
end
table.insert(out, "| " .. table.concat(cells, " || "))
else
col = col + 1
table.insert(out, line)
end
elseif inTable and line:match("^%s*|}") then
elseif inTable and line:match("^%s*|}") then
inTable = false
inTable = false
table.insert(out, line)
table.insert(out, line)
else
else
table.insert(out, line)
table.insert(out, line)
end
end
end
end
return table.concat(out, "\n")
return table.concat(out, "\n")
end
end


--------------------------------------------------------------------------------
-- Trade-agreement generation cutoff
-- Cult sign-off list for trade agreements
-- The Nysara Velai sign-off on 27/3/53 PSSC concluded the locality-alignment phase.
--------------------------------------------------------------------------------
-- Historical output through that date remains reproducible, but all dates from
-- 28/3/53 PSSC onward hard-return '-' in the Trade agreement column.
local TRADE_SIGNOFF_FINAL_YEAR = 53
local TRADE_SIGNOFF_FINAL_DAY = 149 -- 27/3/53 PSSC


local function tradeAgreementGenerationClosed(args)
local year = tonumber(args.year or args.psscyear) or 0
local day = tonumber(args.day or args.dayofyear) or 0
if year > TRADE_SIGNOFF_FINAL_YEAR then
return true
end
if year == TRADE_SIGNOFF_FINAL_YEAR and day > TRADE_SIGNOFF_FINAL_DAY then
return true
end
return false
end
-- Cult sign-off list for Temple Bank trade agreements
local tradeSigningCults = {
local tradeSigningCults = {
{
{ code = "UMB", label = "[[Noctis (Reformed Stripping Path)#Order of the Umbral Oracle|Order of the Umbral Oracle]]" },
code = "UMB",
{ code = "GGS", label = "[[Chrysos (Reformed Stripping Path)#Guild of Golden Shadows|Guild of Golden Shadows]]" },
flag = "UmbOracle.png",
{ code = "AZS", label = "[[Thalassa (Reformed Stripping Path)#Azure Sentinel Sect|Azure Sentinel Sect]]" },
label = "[[Noctis (Reformed Stripping Path)#Order of the Umbral Oracle|Order of the Umbral Oracle]]"
{ code = "HAR", label = "[[Micras (Reformed Stripping Path)#Harmony Sanctum|Harmony Sanctum]]" },
},
{ code = "VIT", label = "[[Plateau (Reformed Stripping Path)#Sanctum Vitalis|Sanctum Vitalis]]" },
{
{ code = "AUR", label = "[[Eos (Reformed Stripping Path)#Order of Aurora Mystica|Order of Aurora Mystica]]" },
code = "GGS",
{ code = "DEL", label = "[[Sisera (Reformed Stripping Path)#Sanctum Delphica|Sanctum Delphica]]" },
flag = "GoldenShadows.png",
{ code = "CAT", label = "[[Cato (Reformed Stripping Path)#Rex Catonis|Rex Catonis]]" },
label = "[[Chrysos (Reformed Stripping Path)#Guild of Golden Shadows|Guild of Golden Shadows]]"
{ code = "CON", label = "[[Lukedu (Reformed Stripping Path)#Accord Concordia|Accord Concordia]]" },
},
{ code = "STY", label = "[[Styx (Reformed Stripping Path)#Mystery of the Stygian Veil|Mystery of the Stygian Veil]]" }
{
code = "AZS",
flag = "AzureSentinel.png",
label = "[[Thalassa (Reformed Stripping Path)#Azure Sentinel Sect|Azure Sentinel Sect]]"
},
{
code = "HAR",
flag = "Harmonysanctum.png",
label = "[[Micras (Reformed Stripping Path)#Harmony Sanctum|Harmony Sanctum]]"
},
{
code = "VIT",
flag = "Vitalis.png",
label = "[[Plateau (Reformed Stripping Path)#Sanctum Vitalis|Sanctum Vitalis]]"
},
{
code = "AUR",
flag = "Auroramystica.png",
label = "[[Eos (Reformed Stripping Path)#Order of Aurora Mystica|Order of Aurora Mystica]]"
},
{
code = "DEL",
flag = "SanctumDel.png",
label = "[[Sisera (Reformed Stripping Path)#Sanctum Delphica|Sanctum Delphica]]"
},
{
code = "CAT",
flag = "Catonis.png",
label = "[[Cato (Reformed Stripping Path)#Rex Catonis|Rex Catonis]]"
},
{
code = "CON",
flag = "Concordia.png",
label = "[[Lukedu (Reformed Stripping Path)#Accord Concordia|Accord Concordia]]"
},
{
code = "STY",
flag = "StygianVe.png",
label = "[[Styx (Reformed Stripping Path)#Mystery of the Stygian Veil|Mystery of the Stygian Veil]]"
}
}
}


local tradeOutcomes = {
local tradeOutcomes = {
"Trade agreement countersigned; company cleared for addition to the appropriate [[General Port of Lake Morovia]] ledger pending ordinary page update.",
"Cleared for General Port ledger review.",
"Provisional General Port admission recommended; company papers transmitted to the Merchant General's audit desk for category placement.",
"Provisional admission recommended.",
"Conditional trade window approved; first-cycle output, route papers, and stipend-voucher handling placed under Port review.",
"Conditional trade window approved.",
"Company charter accepted for corridor listing; local cult sign-off attached to the General Port admission file.",
"Company charter accepted for corridor listing.",
"Trade agreement filed without public ceremony; company admitted through ordinary registry channels to avoid inflaming corridor tensions."
"Trade agreement filed through ordinary registry channels."
}
}


--------------------------------------------------------------------------------
local function tradeAgreementCell(args, channel, rowNumber, loc)
-- Trade-agreement record helper
if tostring(channel or "") ~= "missionary" then return "-" end
--------------------------------------------------------------------------------
if not loc then return "-" end
if tradeAgreementGenerationClosed(args) then return "-" end


local function tradeAgreementRecordForDate(args, year, day)
local chance = imperialSupportBoostedChance(
local chance = tonumber((args or {}).tradechance or (args or {}).tradeChance) or 8
args,
if chance < 0 then chance = 0 end
loc,
if chance > 100 then chance = 100 end
tonumber(args.tradechance or args.tradeChance) or 3,
3
)
chance = nysaraVelaiAdjustedTradeChance(args, loc, chance)


year = tonumber(year) or 0
local year = tonumber(args.year or args.psscyear) or 0
day = tonumber(day) or 0
local day = tonumber(args.day or args.dayofyear) or 0
local seed = tostring(args.seed or "") ..
":SS-TEMPLE-TRADE-COL:" .. tostring(rowNumber or 0) ..
":" .. tostring(loc.code or "GEN") ..
":" .. tostring(year) ..
":" .. tostring(day)


local seed = tostring((args or {}).seed or "") .. ":SS-TRADE:" .. tostring(year) .. ":" .. tostring(day)
local roll = pctFromSeed(seed, "roll") + 1
local roll = pctFromSeed(seed, "roll") + 1
if roll > chance then
if roll > chance then
return nil
if yn(args.showTradeNoEvent or args.showtradenoevent, false) then return "No sign-off" end
return "-"
end
end


local city = pick(southernTradeCities, seed, "city")
local cult = pick(tradeSigningCults, seed, "cult")
local cult = pick(tradeSigningCults, seed, "cult")
local outcome = pick(tradeOutcomes, seed, "outcome")
local outcome = pick(tradeOutcomes, seed, "outcome")
if not city or not cult then return nil end
if not cult then return "-" end


local seq = (pctFromSeed(seed, "seq") % 20) + 1
local seq = (pctFromSeed(seed, "seq") % 20) + 1
local tradeId
local tradeId
if year > 0 and day > 0 then
if year > 0 and day > 0 then
tradeId = string.format("GP-SS-%03d.%03d-%s-%02d", year, day, city.code or "GEN", seq)
tradeId = string.format("GP-SS-%03d.%03d-%s-%02d", year, day, loc.code or "GEN", seq)
else
else
tradeId = string.format("GP-SS-%s-%02d", city.code or "GEN", seq)
tradeId = string.format("GP-SS-%s-%02d", loc.code or "GEN", seq)
end
end
local signCode = string.format("%s-TA%02d", cult.code or "CUL", seq)
local signCode = string.format("%s-TA%02d", cult.code or "CUL", seq)
local advNote = adversaryNotePart(args, "trade", seed, nil, loc)
return "'''Trade sign-off'''<br>" ..
"<small>" .. tradeId .. "</small><br>" ..
(cult.label or "Cult sign-off recorded") .. "<br>" ..
"<small>Code: '''" .. signCode .. "'''<br>" .. outcome .. advNote .. "</small>"
end


return {
-- Rebellion / corridor unrest row column
year = year,
local rebellionProfiles = {
day = day,
{ label = "Confederacy-adjacent courier screen", description = "False-route couriers testing inspection gaps.", adversaries = { "SUYANA" } },
date = dateLabel({ year = year, day = day }),
{ label = "Former Maritime Markets broker faction", description = "Old broker-house retainers resisting General Port paperwork.", adversaries = { "KHADIR" } },
city = city,
{ label = "Anti-registry dock syndicate", description = "Warehouse intermediaries opposing voucher and ledger discipline.", adversaries = { "KHADIR" } },
cult = cult,
{ label = "False-proclamation circle", description = "Pamphlet readers circulating forged civic orders.", adversaries = { "KHADIR", "SUYANA" } },
outcome = outcome,
{ label = "Route-barricade committee", description = "Agitators obstructing lawful inspection lanes.", adversaries = { "SUYANA" } },
tradeId = tradeId,
{ label = "Dispossessed-sympathetic quay cell", description = "Waterfront cell copying Confederacy-style courier habits.", adversaries = { "SUYANA" } },
signCode = signCode
{ label = "Illicit ritual-cargo and medical-transfer exploiters", description = "Handlers using illness, mourning, ritual cargo, or shrine protection to delay inspection.", adversaries = { "SUYANA" } },
}
{ label = "Bromian Ledger witness screen", description = "Broker-linked witnesses preserving conflicting older records against General Port review.", adversaries = { "KHADIR" } }
end
}


local function admissionMap(args)
local rebellionTriggers = {
args = args or {}
"Forged levy notice.",
local map = {}
"Masked speakers redirected traffic.",
"Missing seals and altered registry slips.",
"Crowd pressure over bonded cargo.",
"Tampered signal schedule.",
"Conflicting route orders.",
"Coordinated paper strike.",
"Anti-Bassaridian chant movement.",
"Repeated courier handoffs.",
"Matched false manifests.",
"False medical-transfer exemption.",
"Unreconciled caravan lodging roll.",
"Guide-house witness contradiction.",
"Older Maritime Markets clearance invoked."
}


local toYear, toDay = resolveDate(args)
local rebellionActions = {
"CKD cordon and evidence hold.",
"Temple rumor-control desk opened.",
"Ledgers and copied seals sealed.",
"Privateer stand-off posture.",
"Pass papers reissued.",
"Lawful cargo separated.",
"Missionary mediation opened.",
"Corrected signal notice issued.",
"Temporary General Port audit lane opened.",
"Incident classified as contained unrest.",
"Guide-license review opened.",
"Medical-transfer custody ledger corrected.",
"Broker-house witnesses summoned for countersignature.",
"Night-road registry temporarily frozen."
}


local fromYear = tonumber(args.fromyear or args.startyear or args.admissionfromyear) or toYear
local rebellionRisks = { "Low", "Moderate", "High", "Contained", "Escalating" }
local fromDay = tonumber(args.fromday or args.startday or args.admissionfromday) or 1
local rebellionAlertExcludedLocalities = { MIR = true, SAR = true, THQ = true }


if fromYear <= 0 then fromYear = toYear end
local function isRebellionAlertExcluded(loc)
if fromDay < 1 then fromDay = 1 end
if not loc then return false end
if fromDay > 183 then fromDay = 183 end
return rebellionAlertExcludedLocalities[tostring(loc.code or "")] == true
if toDay < 1 then toDay = 1 end
end
if toDay > 183 then toDay = 183 end


for y = fromYear, toYear do
local function rebellionAlertCell(args, channel, rowNumber, loc)
local dStart = 1
if not loc then return "-" end
local dEnd = 183
if isRebellionAlertExcluded(loc) then return "-" end


if y == fromYear then dStart = fromDay end
local baseChance = tonumber(args.rebellionchance or args.rebellionChance or args.unrestchance or args.unrestChance) or 6
if y == toYear then dEnd = toDay end
local chance = missionAdjustedUnrestChance(args, loc, baseChance)
chance = nysaraVelaiAdjustedUnrestChance(args, loc, chance)


for d = dStart, dEnd do
local year = tonumber(args.year or args.psscyear) or 0
local rec = tradeAgreementRecordForDate(args, y, d)
local day = tonumber(args.day or args.dayofyear) or 0
if rec and rec.city and rec.city.code then
local seed = tostring(args.seed or "") ..
local code = rec.city.code
":SS-REBELLION-COL:" .. tostring(channel or "") ..
if not map[code] then
":" .. tostring(rowNumber or 0) ..
map[code] = rec
":" .. tostring(loc.code or "GEN") ..
end
":" .. tostring(year) ..
end
":" .. tostring(day)
 
local roll = pctFromSeed(seed, "roll") + 1
if roll > chance then
if yn(args.showRebellionNoEvent or args.showrebellionnoevent or args.showUnrestNoEvent or args.showunrestnoevent, false) then
return "No unrest"
end
end
return "-"
end
end


return map
local profile = pick(rebellionProfiles, seed, "profile")
local trigger = pick(rebellionTriggers, seed, "trigger")
local action = pick(rebellionActions, seed, "action")
local risk = pick(rebellionRisks, seed, "risk")
if not profile then return "-" end
 
local seq = (pctFromSeed(seed, "seq") % 20) + 1
local eventId
if year > 0 and day > 0 then
eventId = string.format("SS-RB-%03d.%03d-%s-%02d", year, day, loc.code or "GEN", seq)
else
eventId = string.format("SS-RB-%s-%02d", loc.code or "GEN", seq)
end
local advNote = adversaryNotePart(args, "unrest", seed, profile, loc)
return "'''Unrest alert'''<br>" ..
"<small>" .. eventId .. "</small><br>" ..
"'''Profile:''' " .. profile.label .. "<br>" ..
"<small>" .. profile.description .. "<br>" ..
"'''Trigger:''' " .. trigger .. "<br>" ..
"'''Risk:''' " .. risk .. "<br>" ..
"'''Response:''' " .. action .. advNote .. "</small>"
end
end


--------------------------------------------------------------------------------
-- Compliance observed / minor positive row column
-- Rare Southern Strait trade-agreement / General Port admission events
local complianceProfiles = {
--------------------------------------------------------------------------------
{ label = "Inspection cooperation", description = "Local carriers complied with inspection sequencing without requiring escalation.", adversaries = { "SUYANA" } },
{ label = "Ledger correction", description = "Route clerks corrected incomplete or inconsistent paperwork before formal penalty.", adversaries = { "KHADIR" } },
{ label = "Crowd dispersal", description = "Local stewards dispersed a gathering before it became an obstruction.", adversaries = { "SUYANA" } },
{ label = "Guide assistance", description = "Licensed guides helped separate lawful traffic from suspect courier movement.", adversaries = { "SUYANA" } },
{ label = "Cargo separation", description = "Bonded cargo was voluntarily separated for review without disrupting ordinary passage.", adversaries = { "KHADIR" } },
{ label = "Rumor-control compliance", description = "Temple notices were accepted locally and hostile rumors lost momentum.", adversaries = { "KHADIR", "SUYANA" } },
{ label = "Privateer signal compliance", description = "Vessels accepted stand-off or hold-and-release signals without resistance.", adversaries = { "SUYANA" } },
{ label = "Registry cooperation", description = "Local registrars preserved names, seals, and witness records for later review.", adversaries = { "KHADIR" } },
{ label = "Medical-transfer ledger cooperation", description = "Clinic escorts preserved patient custody records without accepting false sacred exemptions.", adversaries = { "SUYANA" } }
}
 
local complianceOutcomes = {
"Minor positive compliance noted.",
"Recorded as a stabilizing local action.",
"Accepted as offsetting evidence against wider noncompliance.",
"Filed as a documented good-faith response.",
"Preserved for future compliance comparison.",
"Marked as below trade-agreement threshold but operationally helpful."
}
 
local function complianceObservedCell(args, channel, rowNumber, loc)
if not loc then return "-" end
local baseChance = tonumber(args.compliancechance or args.complianceChance or args.observedchance or args.observedChance) or 8
local chance = missionAdjustedComplianceChance(args, loc, baseChance)
chance = imperialSupportBoostedChance(args, loc, chance, 10)
chance = nysaraVelaiAdjustedComplianceChance(args, loc, chance)
 
local year = tonumber(args.year or args.psscyear) or 0
local day = tonumber(args.day or args.dayofyear) or 0
local seed = tostring(args.seed or "") ..
":SS-COMPLIANCE-COL:" .. tostring(channel or "") ..
":" .. tostring(rowNumber or 0) ..
":" .. tostring(loc.code or "GEN") ..
":" .. tostring(year) ..
":" .. tostring(day)
 
local roll = pctFromSeed(seed, "roll") + 1
if roll > chance then
if yn(args.showComplianceNoEvent or args.showcompliancenoevent, false) then return "No observation" end
return "-"
end


local function tradeAgreementEvent(args)
local profile = pick(complianceProfiles, seed, "profile")
args = args or {}
local outcome = pick(complianceOutcomes, seed, "outcome")
local showNoEvent = yn(args.showTradeNoEvent or args.showtradenoevent, false)
if not profile then return "-" end


local year, day = resolveDate(args)
local seq = (pctFromSeed(seed, "seq") % 20) + 1
local rec = tradeAgreementRecordForDate(args, year, day)
local eventId
if year > 0 and day > 0 then
eventId = string.format("SS-CO-%03d.%03d-%s-%02d", year, day, loc.code or "GEN", seq)
else
eventId = string.format("SS-CO-%s-%02d", loc.code or "GEN", seq)
end
local advNote = adversaryNotePart(args, "compliance", seed, profile, loc)
return "'''Compliance observed'''<br>" ..
"<small>" .. eventId .. "</small><br>" ..
"'''Profile:''' " .. profile.label .. "<br>" ..
"<small>" .. profile.description .. "<br>" ..
"'''Outcome:''' " .. outcome .. advNote .. "</small>"
end


if not rec then
-- Row-column insertion helper
if showNoEvent then
local function addCorridorColumns(body, args, channel)
return "''No new Southern Strait trade-agreement sign-off recorded for " .. dateLabel(args) .. ".''"
body = tostring(body or "")
end
if not body:find("{|", 1, true) then return body end
return nil
 
local showLocalityColumn = yn(args.rowlocalities or args.localities or args.showlocalities, true)
local showTradeColumn = yn(args.tradecolumn or args.tradecolumns or args.showtradecolumn, true)
local showComplianceColumn = yn(args.compliancecolumn or args.compliancecolumns or args.observedcolumn or args.showcompliancecolumn, true)
local showRebellionColumn = yn(args.rebellioncolumn or args.rebellioncolumns or args.unrestcolumn or args.showrebellioncolumn, true)
if not showLocalityColumn and not showTradeColumn and not showComplianceColumn and not showRebellionColumn then
return body
end
end


local city = rec.city
local lines = mw.text.split(body, "\n", true)
local cult = rec.cult
local out = {}
local inTable = false
local headerInserted = false
local rowNumber = 0
local localityState = newLocalityAssignmentState(args, channel)


return table.concat({
for _, line in ipairs(lines) do
"{| class=\"wikitable sortable\"",
if line:match("^%s*{|") then
"! Date",
inTable = true
"! Trade-ID",
headerInserted = false
"! Settlement",
table.insert(out, line)
"! Company",
elseif inTable and not headerInserted and line:match("^%s*!") then
"! General Port category",
if showLocalityColumn then table.insert(out, "! Locality focus") end
"! Resource focus",
if showTradeColumn then table.insert(out, "! Trade agreement") end
"! Economic lineage",
if showComplianceColumn then table.insert(out, "! Compliance observed") end
"! Cult sign-off",
if showRebellionColumn then table.insert(out, "! Rebellion alert") end
"! Outcome",
headerInserted = true
"|-",
table.insert(out, line)
"| " .. rec.date,
elseif inTable and line:match("^%s*|%-") then
"| " .. rec.tradeId,
rowNumber = rowNumber + 1
"| " .. city.city .. "<br><small>" .. city.region .. "</small>",
local loc = rowLocalityData(args, channel, rowNumber, localityState)
"| " .. city.company,
table.insert(out, line)
"| " .. city.category,
if showLocalityColumn then table.insert(out, "| " .. rowLocalityText(loc)) end
"| " .. city.resource,
if showTradeColumn then table.insert(out, "| " .. tradeAgreementCell(args, channel, rowNumber, loc)) end
"| " .. (city.lineage or "Local economy tied to Southern Strait corridor trade and General Port admission review."),
if showComplianceColumn then table.insert(out, "| " .. complianceObservedCell(args, channel, rowNumber, loc)) end
"| " .. flagLabel(cult.flag, cult.label) .. "<br><small>Sign-off code: '''" .. rec.signCode .. "'''</small>",
if showRebellionColumn then table.insert(out, "| " .. rebellionAlertCell(args, channel, rowNumber, loc)) end
"| " .. rec.outcome,
elseif inTable and line:match("^%s*|}") then
"|}"
inTable = false
}, "\n")
table.insert(out, line)
else
table.insert(out, line)
end
end
return table.concat(out, "\n")
end
end


--------------------------------------------------------------------------------
-- Main Southern Strait-only view
-- Main Southern Strait-only view
--------------------------------------------------------------------------------
function p.makeTable(frame)
function p.makeTable(frame)
local args = (frame and frame.args) or {}
local args = normalizeArgsDate((frame and frame.args) or {})
 
local showIntro = yn(args.intro, false)
local showIntro = yn(args.intro, false)
local showTitle = yn(args.showtitle or args.titleline, false)
local showTitle = yn(args.showtitle or args.titleline, false)
local showLegend = yn(args.legend or args.showlegend, false)
local showLegend = yn(args.legend or args.showlegend, false)
local collapseSections = yn(args.collapsible, true)
local collapseSections = yn(args.collapsible, true)
local startCollapsed = yn(args.collapsed, true)
local startCollapsed = yn(args.collapsed, true)
 
local includeWar = yn(args.war or args.warleague, true)
local includeWar     = yn(args.war or args.warleague, true)
local includeHatch = yn(args.hatch or args.hatchministry, true)
local includeHatch   = yn(args.hatch or args.hatchministry, true)
local includeMission = yn(args.missionary or args.templebank, true)
local includeMission = yn(args.missionary or args.templebank, true)
local includeTrade  = yn(args.trade or args.tradeagreements or args.tradeagreement, true)
local year = args.year or args.psscyear
 
local day = args.day or args.dayofyear
local showRowLocalities = yn(args.rowlocalities or args.localities or args.showlocalities, true)
 
local year, day = resolveDate(args)
 
local title = args.title or "Southern Strait Corridor Daily Operations"
local title = args.title or "Southern Strait Corridor Daily Operations"
local label = dateLabel({ year = year, day = day })
local label = dateLabel(args)
 
local out = {}
local out = {}


if showTitle then
if showTitle then table.insert(out, "==" .. title .. "==") end
table.insert(out, "==" .. title .. "==")
end
 
if showIntro then
if showIntro then
table.insert(out, string.format(
table.insert(out, string.format(
"''Southern Strait-only operational display for %s, limited to Haifan Bassaridian / former Maritime Markets corridor entries.''",
"''Southern Strait-only operational display for %s, limited to Mylecian Southern Strait corridor entries.''",
label
label
))
))
table.insert(out, "")
table.insert(out, "")
table.insert(out, "This display combines War League deployments, Hatch Ministry privateer activity, Temple Bank missionary operations, rare General Port trade-agreement sign-offs, and row-level Southern Strait locality focus columns while excluding unrelated regional rows.")
table.insert(out,
"This display combines Council of Kings deployments, Hatch Ministry privateer activity, Temple Bank missionary operations, row-level Southern Strait locality focus columns, row-level compliance observations, and row-level rebellion-type unrest alerts while displaying the operational City/Node as Mylecia. Historical Temple Bank trade sign-offs remain reproducible through 27/3/53 PSSC, but all later Trade agreement cells display '-'. Imperial Federation, Bassaridian Mission, capped-locality, CKD reinforcement concentration, and Temple Bank adversarial-node modifiers are applied where effective."
)
end
 
local ifSupportNotice = imperialFederationSupportNotice(args)
if ifSupportNotice ~= "" then
table.insert(out, ifSupportNotice)
table.insert(out, "")
end
 
local missionNotice = bassaridianMissionsNotice(args)
if missionNotice ~= "" then
table.insert(out, missionNotice)
table.insert(out, "")
end
end


----------------------------------------------------------------------------
local adversaryNotice = adversarialNodesNotice(args)
-- War League: Southern Strait-only
if adversaryNotice ~= "" then
----------------------------------------------------------------------------
table.insert(out, adversaryNotice)
table.insert(out, "")
end


if includeWar then
if includeWar then
Line 566: Line 1,276:
flagsize = args.flagsize or "20",
flagsize = args.flagsize or "20",
zone = "SouthernStrait",
zone = "SouthernStrait",
division = "Council of Kings Division"
}
}
 
if args.seed and tostring(args.seed) ~= "" then warArgs.seed = args.seed end
if args.division and tostring(args.division) ~= "" then
local _, body = safeCall("Module:WarLeagueDivisionOpsBVR", "makeTable", warArgs)
warArgs.division = args.division
body = forceMyleciaCityNodeColumn(body, args)
elseif args.wardivision and tostring(args.wardivision) ~= "" then
body = addCorridorColumns(body, args, "war")
warArgs.division = args.wardivision
end
 
if args.seed and tostring(args.seed) ~= "" then
warArgs.seed = args.seed
end
 
local ok, body = safeCall("Module:WarLeagueDivisionOpsBVR", "makeTable", warArgs)
 
if showRowLocalities then
body = addRowLocalities(body, { year = year, day = day, seed = args.seed }, "war")
end
 
table.insert(out, hr())
table.insert(out, hr())
table.insert(out, section("War League Southern Strait deployments", body, collapseSections, startCollapsed))
table.insert(out, section("Council of Kings Southern Strait deployments", body, collapseSections, startCollapsed))
end
end
----------------------------------------------------------------------------
-- Hatch Ministry: Southern Strait-only
----------------------------------------------------------------------------


if includeHatch then
if includeHatch then
Line 597: Line 1,291:
day = day,
day = day,
legend = showLegend and "yes" or "no",
legend = showLegend and "yes" or "no",
zone = "SouthernStrait",
zone = "SouthernStrait"
}
}
 
if args.captain and tostring(args.captain) ~= "" then hatchArgs.captain = args.captain end
if args.captain and tostring(args.captain) ~= "" then
local _, body = safeCall("Module:HatchMinistryDailyOps", "dailyReport", hatchArgs)
hatchArgs.captain = args.captain
body = forceMyleciaCityNodeColumn(body, args)
end
body = swapHatchHomeCityCurrentStation(body, args)
 
body = addCorridorColumns(body, args, "hatch")
local ok, body = safeCall("Module:HatchMinistryDailyOps", "dailyReport", hatchArgs)
 
if showRowLocalities then
body = addRowLocalities(body, { year = year, day = day, seed = args.seed }, "hatch")
end
 
table.insert(out, hr())
table.insert(out, hr())
table.insert(out, section("Hatch Ministry Southern Strait privateer operations", body, collapseSections, startCollapsed))
table.insert(out, section("Hatch Ministry Southern Strait privateer operations", body, collapseSections, startCollapsed))
end
end
----------------------------------------------------------------------------
-- Temple Bank / Missionary Operations: Haifan only
----------------------------------------------------------------------------


if includeMission then
if includeMission then
Line 625: Line 1,309:
showlegend = showLegend and "yes" or "no",
showlegend = showLegend and "yes" or "no",
includeThreat = args.includeThreat or args.includethreat or "no",
includeThreat = args.includeThreat or args.includethreat or "no",
showEcon = args.showEcon or args.showecon or "no",
showEcon = args.showEcon or args.showecon or "no"
}
}
if args.missionarylimit and tostring(args.missionarylimit) ~= "" then
if args.missionarylimit and tostring(args.missionarylimit) ~= "" then
missionaryArgs.limit = args.missionarylimit
missionaryArgs.limit = args.missionarylimit
Line 633: Line 1,316:
missionaryArgs.limit = args.limit
missionaryArgs.limit = args.limit
end
end
 
local _, body = safeCall("Module:MissionaryDailyOpsBVR", "makeTable", missionaryArgs)
local ok, body = safeCall("Module:MissionaryDailyOpsBVR", "makeTable", missionaryArgs)
body = forceMyleciaCityNodeColumn(body, args)
 
body = addCorridorColumns(body, args, "missionary")
if showRowLocalities then
body = addRowLocalities(body, { year = year, day = day, seed = args.seed }, "missionary")
end
 
table.insert(out, hr())
table.insert(out, hr())
table.insert(out, section("Temple Bank Southern Strait missionary operations", body, collapseSections, startCollapsed))
table.insert(out, section("Temple Bank Southern Strait missionary operations", body, collapseSections, startCollapsed))
end
end
----------------------------------------------------------------------------
-- Rare trade-agreement / General Port admission events
----------------------------------------------------------------------------
if includeTrade then
local tradeBody = tradeAgreementEvent({
year = year,
day = day,
seed = args.seed,
tradechance = args.tradechance or args.tradeChance,
showTradeNoEvent = args.showTradeNoEvent or args.showtradenoevent
})
if tradeBody and tostring(tradeBody) ~= "" then
table.insert(out, hr())
table.insert(out, section("Southern Strait trade-agreement sign-offs", tradeBody, collapseSections, startCollapsed))
end
end
----------------------------------------------------------------------------
-- Combined legend
----------------------------------------------------------------------------


if showLegend then
if showLegend then
local legendBody = table.concat({
local legendBody = table.concat({
"* '''War League Southern Strait deployments''' show Haifan Bassaridian / former Maritime Markets security rows only.",
"* '''Council of Kings Southern Strait deployments''' show only Council of Kings Division War League rows for the Southern Strait corridor.",
"* '''Hatch Ministry Southern Strait privateer operations''' show Haifan home-port privateers only.",
"* '''Hatch Ministry Southern Strait privateer operations''' show Southern Strait privateer rows.",
"* '''Temple Bank Southern Strait missionary operations''' show Haifan Bassaridian missionary rows only.",
"* '''Temple Bank Southern Strait missionary operations''' show Haifan Bassaridian missionary rows, but the displayed City/Node is forced to Mylecia in this wrapper.",
"* '''City/Node display''' is forced to [[File:MyleciaFlabB.jpeg|20px]] [[Mylecia]] for War League, Hatch Ministry, and Temple Bank rows.",
"* '''Locality focus''' columns assign one extended Southern Strait, Eastern Mykonos Desert, or eastern Snowholme foothill settlement to each generated row when row-level localities are enabled.",
"* '''Locality focus''' columns assign one extended Southern Strait, Eastern Mykonos Desert, or eastern Snowholme foothill settlement to each generated row when row-level localities are enabled.",
"* '''Southern Strait trade-agreement sign-offs''' are rare or uncommon events allowing companies in Southern Strait, Eastern Mykonos Desert, and eastern Snowholme foothill settlements to be admitted to the appropriate [[General Port of Lake Morovia]] ledger after cult sign-off.",
"* '''CKD reinforcement at Nysara Velai''' assigns six War League locality rows there by default, representing the earlier three deployments plus three additional CKD deployments.",
"* '''Economic lineage''' notes describe how the newer locality economies are influenced by the historic port economies of [[Blore Heath]], [[Jogi]], and [[Mylecia]] without directly copying their companies, commodities, or institutions.",
"* '''CKD reinforcement at Selenarion''' assigns two War League locality rows there by default, representing the earlier deployment plus one additional CKD deployment.",
"* '''Standalone locality tables''' use generated trade-agreement records to mark companies as Independent or General Port of Lake Morovia. If year/day are omitted, the current calculated PSSC date is used."
"* '''Hatch Ministry and Temple Bank locality targets''' remain at three Nysara Velai rows and one Selenarion row per section by default; the CKD reinforcement does not automatically increase those services.",
"* '''Other capped presence localities''' are [[Mirovia]], [[Saruq Thyrsa]], and [[Thal Lenaia]]. Each may appear no more than once per section/channel.",
"* '''Nysara Velai chance modifiers''' add +6 percentage points to compliance-observation likelihood and subtract 6 percentage points from unrest-alert likelihood. Its former +3-point trade-signoff modifier applies only to historical dates through 27/3/53 PSSC.",
"* '''Trade agreement generation is closed''' from 28/3/53 PSSC onward. All channels display '''-''' in that column after the final Nysara Velai agreement; Temple Bank sign-offs remain reproducible only for historical dates through 27/3/53 PSSC.",
"* '''Compliance observed''' columns show minor positive local behavior below the level of a formal trade agreement.",
"* '''Rebellion alert''' columns show rare row-level contained unrest events such as forged proclamations, broker-cell activity, route barricades, false orders, ritual-cargo abuse, medical-transfer exploitation, or Dispossessed-adjacent courier behavior.",
"* '''Mirovia''', '''Saruq Thyrsa''', and '''Thal Lenaia''' are hard-excluded from Rebellion Alert results; their Rebellion Alert cells always display '''-''', even when '''rebellionchance=100''' is used for testing.",
"* '''Recurring adversarial nodes''' apply from 60/2/53 PSSC by default. Eligible rows may occasionally mention [[Khadir Veyran]] or [[Suyana Amaruq]] as suspected influence, but the notes are not guaranteed to appear.",
"* '''Khadir Veyran''' notes are weighted toward broker factions, Bromian Ledger witness screens, anti-registry dock activity, cargo ambiguity, ledger correction, and trade-signoff counterweight language.",
"* '''Suyana Amaruq''' notes are weighted toward courier screens, route barricades, false-pilgrim or guide-house movement, medical-transfer exploitation, and Black-Thread route-intelligence behavior.",
"* '''Adversarial note frequency''' defaults to 35 percent for unrest alerts and 18 percent for compliance observations. The 22-percent trade-signoff note rate applies only to historical trade rows through 27/3/53 PSSC.",
"* '''Imperial Federation support''' applies from 112/53 PSSC by default and adds +10 percentage points to compliance observations for Saruq Thyrsa, Mirovia, and Rumi-Kefaya. Its former +3-point trade-signoff effect is historical only and cannot generate agreements after 27/3/53 PSSC.",
"* '''Bassaridian Missions support''' applies from 55/2/53 PSSC by default. It reduces unrest-alert chance by 1 percentage point in all locality rows and increases compliance-observation chance by 1 percentage point in all locality rows.",
"* '''Major Bassaridian Missions''' at Saruq Thyrsa, Mirovia, Nysara Velai, Thal Lenaia, and Selenarion receive an additional +2 percentage points to compliance observations.",
"* Use '''compliancechance=100''' and '''rebellionchance=100''' for testing. '''tradechance=100''' affects only historical dates through 27/3/53 PSSC and cannot override the post-agreement cutoff.",
"* Use '''warnysaravelaitarget=6''' to change only the War League / CKD Nysara Velai target.",
"* Use '''warselenariontarget=2''' to change only the War League / CKD Selenarion target.",
"* Use '''nysaravelaitarget=3''' or '''selenariontarget=1''' to override the corresponding target in every section/channel.",
"* Use '''nysaravelaioverfill=yes''' to allow Nysara Velai to exceed its section target after the priority rows are assigned.",
"* Use '''nysaravelaicomplianceboost=6''' and '''nysaravelaiunrestreduction=6''' to change the active Nysara Velai modifiers. '''nysaravelaitradeboost=3''' is retained solely for historical reproduction through 27/3/53 PSSC. The older '''nysaravelaiunrestboost=''' parameter remains available as an additive legacy override.",
"* Use '''adversarynodes=no''' to disable named adversarial notes.",
"* Use '''adversarychance=35''' to change the default unrest-alert adversarial note chance.",
"* Use '''complianceadversarychance=18''' to change the default compliance-observation adversarial note chance.",
"* Use '''tradeadversarychance=22''' only to change adversarial-note frequency in historical Temple Bank trade-signoff rows through 27/3/53 PSSC.",
"* Use '''adversarystartyear=53''' and '''adversarystartday=121''' to change the default 60/2/53 PSSC start date for named adversarial-node tracking.",
"* Use '''missionsupport=no''' to disable Bassaridian Missions modifiers for testing.",
"* Use '''imperialsupport=no''' to disable Imperial Federation support modifiers for testing.",
"* Use '''forcemylecia=no''' only if the wrapper should temporarily show the original source-module City/Node values."
}, "\n")
}, "\n")
table.insert(out, hr())
table.insert(out, hr())
table.insert(out, section("Combined legend", legendBody, collapseSections, startCollapsed))
table.insert(out, section("Combined legend", legendBody, collapseSections, startCollapsed))
Line 684: Line 1,368:
end
end


--------------------------------------------------------------------------------
-- Shortcut views
-- Shortcut views
--------------------------------------------------------------------------------
function p.southernStrait(frame)
function p.southernStrait(frame)
local args = (frame and frame.args) or {}
local args = (frame and frame.args) or {}
Line 698: Line 1,379:
args.hatch = "no"
args.hatch = "no"
args.missionary = "no"
args.missionary = "no"
args.trade = "no"
args.war = "yes"
args.war = "yes"
args.title = args.title or "War League Southern Strait Daily Operations"
args.title = args.title or "War League Southern Strait Daily Operations"
Line 708: Line 1,388:
args.war = "no"
args.war = "no"
args.missionary = "no"
args.missionary = "no"
args.trade = "no"
args.hatch = "yes"
args.hatch = "yes"
args.title = args.title or "Hatch Ministry Southern Strait Daily Operations"
args.title = args.title or "Hatch Ministry Southern Strait Daily Operations"
Line 718: Line 1,397:
args.war = "no"
args.war = "no"
args.hatch = "no"
args.hatch = "no"
args.trade = "no"
args.missionary = "yes"
args.missionary = "yes"
args.title = args.title or "Temple Bank Southern Strait Missionary Daily Operations"
args.title = args.title or "Temple Bank Southern Strait Missionary Daily Operations"
return p.makeTable({ args = args })
return p.makeTable({ args = args })
end
--------------------------------------------------------------------------------
-- Standalone locality / General Port status table
--------------------------------------------------------------------------------
function p.localityTable(frame)
local args = (frame and frame.args) or {}
local targetYear, targetDay = resolveDate(args)
local scanArgs = {
year = targetYear,
day = targetDay,
seed = args.seed,
tradechance = args.tradechance or args.tradeChance,
fromyear = args.fromyear or args.startyear or args.admissionfromyear,
fromday = args.fromday or args.startday or args.admissionfromday
}
local admitted = admissionMap(scanArgs)
local out = {}
table.insert(out, "{| class=\"wikitable sortable collapsible\" border=\"1;\" width=\"100%\"")
table.insert(out, "|- bgcolor=\"#e6e6ff\"")
table.insert(out, "! Locality")
table.insert(out, "! Geographic zone")
table.insert(out, "! Terrain and setting")
table.insert(out, "! Primary resource focus")
table.insert(out, "! Principal company or institution")
table.insert(out, "! Status")
table.insert(out, "! General Port category")
table.insert(out, "! Admission record")
table.insert(out, "! Corridor role")
for _, city in ipairs(southernTradeCities) do
local rec = admitted[city.code]
local isPort = rec ~= nil
local rowColor = isPort and "#ddffdd" or "#ffdddd"
local companyTag = isPort and "'''(General Port)'''" or "'''(Independent)'''"
local statusText = isPort and "[[General Port of Lake Morovia]]" or "Independent"
local admissionText
if isPort then
admissionText = rec.date .. "<br>Trade-ID: '''" .. rec.tradeId .. "'''<br>Sign-off: '''" .. rec.signCode .. "'''"
else
admissionText = "No General Port admission event recorded by " .. dateLabel({ year = targetYear, day = targetDay }) .. "."
end
table.insert(out, "|- bgcolor=\"" .. rowColor .. "\"")
table.insert(out, "| '''" .. city.city .. "'''")
table.insert(out, "| " .. city.region)
table.insert(out, "| " .. (city.terrain or "Locality focus within the extended Southern Strait, Eastern Mykonos Desert, or eastern Snowholme foothill corridor."))
table.insert(out, "| " .. city.resource)
table.insert(out, "| " .. city.company .. " " .. companyTag)
table.insert(out, "| " .. statusText)
table.insert(out, "| " .. city.category)
table.insert(out, "| " .. admissionText)
table.insert(out, "| " .. (city.role or city.lineage or "Secondary locality focus used for inspection, escort, registry, trade-agreement, infrastructure, or route-security activity."))
end
table.insert(out, "|}")
return table.concat(out, "\n")
end
end


return p
return p

Latest revision as of 16:34, 22 July 2026

Documentation for this module may be created at Module:SouthernStraitCorridorOps/doc 

-- Module:SouthernStraitCorridorOps
-- CKD reinforcement at Nysara Velai and Selenarion
-- Post-agreement Southern Strait operations:
--   +6 percentage points to Nysara Velai Compliance Observed
--   -6 percentage points to Nysara Velai Rebellion Alert
--   historical trade sign-offs preserved through 27/3/53 PSSC
--   all future trade-agreement generation disabled from 28/3/53 PSSC onward

local p = {}

-- Helpers
local function yn(value, default)
	local v = tostring(value or ""):lower()
	if v == "" then return default end
	if v == "no" or v == "n" or v == "0" or v == "false" then return false end
	if v == "yes" or v == "y" or v == "1" or v == "true" then return true end
	return default
end

local function makeFrame(args)
	return { args = args or {} }
end

local function getCurrentPSSCDate()
	local startDate = os.time({ year = 1999, month = 8, day = 6, hour = 0 })
	local secondsInDay = 86400
	local daysPerYear = 183
	local currentDate = os.time()
	local totalDaysElapsed = math.floor((currentDate - startDate) / secondsInDay)
	local psscYear = math.floor(totalDaysElapsed / daysPerYear)
	local dayOfYear = (totalDaysElapsed % daysPerYear) + 1
	if dayOfYear < 1 then dayOfYear = 1 end
	if dayOfYear > 183 then dayOfYear = 183 end
	return psscYear, dayOfYear
end

local function normalizeArgsDate(args)
	local out = {}
	for k, v in pairs(args or {}) do
		out[k] = v
	end

	local y = tonumber(out.year or out.psscyear)
	local d = tonumber(out.day or out.dayofyear)
	if not y or not d then
		y, d = getCurrentPSSCDate()
	end

	out.year = tostring(y)
	out.day = tostring(d)
	out.psscyear = tostring(y)
	out.dayofyear = tostring(d)
	return out
end

local function safeRequire(moduleName)
	local ok, mod = pcall(require, moduleName)
	if ok and mod then
		return mod, nil
	end
	return nil, "Could not load " .. tostring(moduleName)
end

local function safeCall(moduleName, funcName, args)
	local mod, err = safeRequire(moduleName)
	if not mod then
		return false, "''" .. err .. ".''"
	end
	if type(mod[funcName]) ~= "function" then
		return false, "''" .. tostring(moduleName) .. " has no public function named " .. tostring(funcName) .. ".''"
	end

	local ok, result = pcall(function()
		return mod[funcName](makeFrame(args))
	end)
	if not ok then
		return false, "''Error while invoking " .. tostring(moduleName) .. "." .. tostring(funcName) .. ": " .. tostring(result) .. "''"
	end
	return true, tostring(result or "")
end

local function doyToMonthDom(doy)
	doy = tonumber(doy) or 1
	if doy < 1 then doy = 1 end
	if doy > 183 then doy = 183 end

	if doy <= 61 then
		return 1, doy
	elseif doy <= 122 then
		return 2, doy - 61
	else
		return 3, doy - 122
	end
end

local function dateLabel(args)
	local y = tonumber(args.year or args.psscyear)
	local d = tonumber(args.day or args.dayofyear)
	if y and d then
		local m, dom = doyToMonthDom(d)
		return string.format("%d/%d/%d PSSC", dom, m, y)
	end
	return "current PSSC date"
end

local function section(title, body, collapsible, collapsed)
	local out = {}
	local safeTitle = tostring(title or "Operations")
	local content = tostring(body or "''No output.''")

	if not collapsible then
		table.insert(out, "===" .. safeTitle .. "===")
		table.insert(out, content)
		return table.concat(out, "\n")
	end

	local collapseClass = collapsed and "mw-collapsible mw-collapsed" or "mw-collapsible"
	table.insert(out, '<div class="' .. collapseClass .. '" style="border:1px solid #a2a9b1; margin:0.6em 0; background:#f8f9fa;">')
	table.insert(out, '<div style="font-weight:bold; padding:0.35em 0.6em; background:#eaecf0;">' .. safeTitle .. '</div>')
	table.insert(out, '<div style="padding:0.5em 0.6em;">')
	table.insert(out, content)
	table.insert(out, '</div>')
	table.insert(out, '</div>')
	return table.concat(out, "\n")
end

local function hr()
	return "\n----\n"
end

local function hashString(s)
	s = tostring(s or "")
	local h = 0
	for i = 1, #s do
		h = (h * 31 + string.byte(s, i)) % 1000003
	end
	return h
end

local function pick(list, seed, salt)
	if not list or #list == 0 then return nil end
	local idx = (hashString(tostring(seed or "") .. ":" .. tostring(salt or "")) % #list) + 1
	return list[idx]
end

local function pctFromSeed(seed, salt)
	return hashString(tostring(seed or "") .. ":" .. tostring(salt or "")) % 100
end

local function clampChance(value)
	value = tonumber(value) or 0
	if value < 0 then return 0 end
	if value > 100 then return 100 end
	return value
end

local function isOnOrAfterPSSCDate(year, day, startYear, startDay)
	year = tonumber(year) or 0
	day = tonumber(day) or 0
	startYear = tonumber(startYear) or 0
	startDay = tonumber(startDay) or 0
	if year > startYear then return true end
	if year == startYear and day >= startDay then return true end
	return false
end

-- Extended Southern Strait / Eastern Mykonos / Snowholme locality list
local southernTradeCities = {
	{
		code = "MIR",
		city = "[[Mirovia]]",
		region = "[[Eastern Mykonos]] Desert",
		category = "Agriculture",
		company = "[[Mirovian Cistern Growers' Syndicate]]",
		resource = "cistern-grown melons, dryland cucumbers, preserved desert fruit, seed oil, packed caravan rations, and water-accounted produce consignments",
		lineage = "Desert provisioning economy influenced by [[Jogi]]'s food-market role and [[Mylecia]]'s caravan-facing trade networks; adapted to cistern agriculture, water claims, and dry-route supply rather than beer, grain, or ritual crops"
	},
	{
		code = "SAR",
		city = "[[Saruq Thyrsa]]",
		region = "Southern Strait coast",
		category = "Agriculture",
		company = "[[Saruq Thyrsa Reedcutters' Guild]]",
		resource = "coastal reed, cane fiber, packing straw, ferry mats, cargo-padding material, rope backing, warehouse thatch, and crate-lining bundles",
		lineage = "Harbor-materials economy influenced by [[Blore Heath]]'s shipping brokerage and [[Jogi]]'s quay-market supply system; focused on practical cargo handling, ferry shelters, and packing materials rather than piracy or cult goods"
	},
	{
		code = "AYS",
		city = "[[Nysara Velai]]",
		region = "Eastern foothills of the [[Snowholme Range]]",
		category = "Agriculture",
		company = "[[Nysaran Terrace Farmers' Cooperative]]",
		resource = "terrace beans, cold-weather tubers, sheep wool, highland fodder, pack-animal feed, preserved root stores, and mule-train provisions",
		lineage = "Foothill supply economy influenced only indirectly by the Maritime Markets; tied more closely to Snowholme terrace farming, upland food storage, wool traffic, and pass-road provisioning"
	},
	{
		code = "THQ",
		city = "[[Thal Lenaia]]",
		region = "Eastern foothills of the [[Snowholme Range]]",
		category = "Agriculture",
		company = "[[Thal Lenaia Springkeepers' Cooperative]]",
		resource = "spring-fed watercress, trout ponds, smoked fish, cold-storage greens, inspected mountain food shipments, packed ice-box produce, and road-market fish consignments",
		lineage = "Foothill water-and-food economy tied to Snowholme springs and pass roads; comparable to older Maritime Markets food distribution only in its role as a regulated supplier to travelers, markets, and route offices"
	},
	{
		code = "RUK",
		city = "[[Rumi-Kefaya]]",
		region = "[[Eastern Mykonos]] Desert",
		category = "Mining / Manufacturing / Energy",
		company = "[[Rumi-Kefaya Stone and Lime Works]]",
		resource = "basalt, limestone, paving stone, railway ballast, drainage tile, lime mortar, culvert blocks, harbor repair stone, quay coping, and storm-route masonry",
		lineage = "Infrastructure economy influenced by [[Mylecia]]'s coal-and-works tradition and Southern Strait coastal preservation activity; focused on roads, quays, culverts, retaining walls, and storm-damage repair rather than extractive wealth"
	},
	{
		code = "HAY",
		city = "[[Hayr Chaskal]]",
		region = "Southern Strait coast",
		category = "Mining / Manufacturing / Energy",
		company = "[[Hayr Chaskal Glass and Signal Works]]",
		resource = "beacon glass, telegraph insulators, lighthouse lenses, lamp glass, storm panes, signal mirrors, buoy lenses, and weatherproof signal housings",
		lineage = "Signal-and-navigation economy influenced by [[Blore Heath]]'s shipping control and [[Mylecia]]'s coastal works; supports ferry warnings, lighthouse maintenance, telegraph lines, and Hatch Ministry watch posts without copying older pirate or brokerage firms"
	},
	{
		code = "QSE",
		city = "[[Selenarion]]",
		region = "Eastern foothills of the [[Snowholme Range]]",
		category = "Services",
		company = "[[Selenarion Route Registry Office]]",
		resource = "night-road registry, caravan lodging, pass permits, route insurance, guide licensing, cargo-route papers, missing-traveler filings, and bonded transit records",
		lineage = "Foothill route-service economy influenced by [[Mylecia]]'s caravan-facing commerce and [[Jogi]]'s intelligence-and-paperwork traditions; adapted to Snowholme pass roads, guide houses, lodging records, and insurance claims"
	}
}

-- Locality presence controls
-- In the CKD / War League section, AYS receives six rows and QSE receives two.
-- Hatch Ministry and Temple Bank retain three AYS rows and one QSE row.
local cappedPresenceLocalities = {
	MIR = true,
	SAR = true,
	THQ = true
}

local function findLocalityByCode(code)
	code = tostring(code or "")
	for _, loc in ipairs(southernTradeCities or {}) do
		if tostring(loc.code or "") == code then
			return loc
		end
	end
	return nil
end

local function localityCount(state, locOrCode)
	if not state or not state.counts then return 0 end
	local code
	if type(locOrCode) == "table" then
		code = tostring(locOrCode.code or "")
	else
		code = tostring(locOrCode or "")
	end
	return tonumber(state.counts[code]) or 0
end

local function incrementLocalityCount(state, loc)
	if not state or not loc then return end
	local code = tostring(loc.code or "")
	if code == "" then return end
	state.counts[code] = (tonumber(state.counts[code]) or 0) + 1
end

local function nysaraVelaiPresenceTarget(args, channel)
	local isWar = tostring(channel or "") == "war"
	local v
	if isWar then
		v = tonumber(
			args.warnysaravelaitarget or
			args.warNysaraVelaiTarget or
			args.warnysaratarget or
			args.warNysaraTarget or
			args.waraystarget or
			args.warAysTarget
		)
	end
	if v == nil then
		v = tonumber(
			args.nysaravelaitarget or
			args.nysaraVelaiTarget or
			args.nysaratarget or
			args.nysaraTarget or
			args.aystarget or
			args.aysTarget
		)
	end
	if v == nil then v = isWar and 6 or 3 end
	if v < 0 then v = 0 end
	return math.floor(v)
end

local function selenarionPresenceTarget(args, channel)
	local isWar = tostring(channel or "") == "war"
	local v
	if isWar then
		v = tonumber(
			args.warselenariontarget or
			args.warSelenarionTarget or
			args.warqsetarget or
			args.warQseTarget
		)
	end
	if v == nil then
		v = tonumber(
			args.selenariontarget or
			args.selenarionTarget or
			args.qsetarget or
			args.qseTarget
		)
	end
	if v == nil then v = isWar and 2 or 1 end
	if v < 0 then v = 0 end
	return math.floor(v)
end

local function nysaraVelaiAllowOverTarget(args)
	return yn(
		args.nysaravelaioverfill or
		args.nysaraVelaiOverfill or
		args.nysaraoverfill or
		args.nysaraOverfill or
		args.aysoverfill or
		args.aysOverfill,
		false
	)
end

local function buildPriorityLocalityPlan(args, channel)
	local plan = {}
	local nysaraTarget = nysaraVelaiPresenceTarget(args, channel)
	local selenarionTarget = selenarionPresenceTarget(args, channel)
	for _ = 1, nysaraTarget do table.insert(plan, "AYS") end
	for _ = 1, selenarionTarget do table.insert(plan, "QSE") end
	return plan
end

local function newLocalityAssignmentState(args, channel)
	return {
		channel = tostring(channel or ""),
		counts = {},
		aysTarget = nysaraVelaiPresenceTarget(args, channel),
		aysAllowOverTarget = nysaraVelaiAllowOverTarget(args),
		qseTarget = selenarionPresenceTarget(args, channel),
		priorityPlan = buildPriorityLocalityPlan(args, channel)
	}
end

local function canAssignLocality(args, loc, state)
	if not loc then return false end
	local code = tostring(loc.code or "")
	if cappedPresenceLocalities[code] and localityCount(state, code) >= 1 then
		return false
	end
	if code == "AYS" and state and not state.aysAllowOverTarget then
		if localityCount(state, code) >= (tonumber(state.aysTarget) or 3) then
			return false
		end
	end
	if code == "QSE" and state then
		if localityCount(state, code) >= (tonumber(state.qseTarget) or 1) then
			return false
		end
	end
	return true
end

local function priorityLocalityForRow(state, rowNumber)
	if not state or not state.priorityPlan then return nil end
	local row = tonumber(rowNumber) or 0
	local code = state.priorityPlan[row]
	if not code then return nil end
	return findLocalityByCode(code)
end

local function rowLocalityData(args, channel, rowNumber, state)
	if not southernTradeCities or #southernTradeCities == 0 then return nil end
	state = state or newLocalityAssignmentState(args, channel)

	local priorityLoc = priorityLocalityForRow(state, rowNumber)
	if priorityLoc and canAssignLocality(args, priorityLoc, state) then
		incrementLocalityCount(state, priorityLoc)
		return priorityLoc
	end

	local year = tonumber(args.year or args.psscyear) or 0
	local day = tonumber(args.day or args.dayofyear) or 0
	local seed = tostring(args.seed or "") ..
		":SS-ROW-LOCALITY:" .. tostring(channel or "") ..
		":" .. tostring(year) ..
		":" .. tostring(day)

	local offset = hashString(seed) % #southernTradeCities
	local baseRow = tonumber(rowNumber) or 1
	for attempt = 0, #southernTradeCities - 1 do
		local idx = ((baseRow - 1 + offset + attempt) % #southernTradeCities) + 1
		local loc = southernTradeCities[idx]
		if canAssignLocality(args, loc, state) then
			incrementLocalityCount(state, loc)
			return loc
		end
	end

	for _, loc in ipairs(southernTradeCities) do
		local code = tostring(loc.code or "")
		if not cappedPresenceLocalities[code] and code ~= "AYS" and code ~= "QSE" then
			incrementLocalityCount(state, loc)
			return loc
		end
	end
	return nil
end

local function rowLocalityText(loc)
	if not loc then return "Southern Strait corridor" end
	return loc.city .. "<br><small>" .. loc.region .. "</small>"
end

-- Imperial Federation support marker and locality boosts
local IMPERIAL_SUPPORT_START_YEAR = 53
local IMPERIAL_SUPPORT_START_DAY = 112
local imperialFederationSupportLocalities = {
	MIR = true,
	SAR = true,
	RUK = true
}

local function imperialSupportEnabled(args)
	return yn(args.imperialsupport or args.imperialSupport or args.ifsupport or args.ifSupport, true)
end

local function imperialSupportEffective(args)
	if not imperialSupportEnabled(args) then return false end
	local year = tonumber(args.year or args.psscyear) or 0
	local day = tonumber(args.day or args.dayofyear) or 0
	local startYear = tonumber(args.imperialstartyear or args.imperialStartYear) or IMPERIAL_SUPPORT_START_YEAR
	local startDay = tonumber(args.imperialstartday or args.imperialStartDay) or IMPERIAL_SUPPORT_START_DAY
	return isOnOrAfterPSSCDate(year, day, startYear, startDay)
end

local function hasImperialFederationSupport(args, loc)
	if not imperialSupportEffective(args) then return false end
	return loc and imperialFederationSupportLocalities[tostring(loc.code or "")] == true
end

local function imperialSupportBoostedChance(args, loc, baseChance, boost)
	local chance = clampChance(baseChance)
	if hasImperialFederationSupport(args, loc) then
		chance = chance + (tonumber(boost) or 0)
	end
	return clampChance(chance)
end

local function imperialFederationSupportNotice(args)
	if not imperialSupportEffective(args) then return "" end
	return "'''Imperial Federation support present:''' [[2nd Brigade, 25th Division of the Imperial Marines]] deployed in allied support of Bassaridian Southern Strait corridor activity around [[Saruq Thyrsa]], [[Mirovia]], and [[Rumi-Kefaya]].<br>" ..
		"<small>Mechanized, mixed-capability support of approximately 4,000 soldiers reinforces route security, inspection cordons, convoy spacing, engineering liaison, and lawful corridor stabilization. " ..
		"Locality rows for Saruq Thyrsa, Mirovia, and Rumi-Kefaya receive +10 percentage points to compliance observations. The former +3-point Temple Bank trade-signoff modifier remains relevant only when reproducing historical dates through 27/3/53 PSSC; all later trade-agreement generation is closed.</small>"
end

-- Bassaridian Missions support marker and locality adjustments
local BASSARIDIAN_MISSIONS_START_YEAR = 53
local BASSARIDIAN_MISSIONS_START_DAY = 116
local majorBassaridianMissionLocalities = {
	SAR = true,
	MIR = true,
	AYS = true,
	THQ = true,
	QSE = true
}

local function bassaridianMissionsEnabled(args)
	return yn(args.missionsupport or args.missionSupport or args.bassaridianmissions or args.bassaridianMissions, true)
end

local function bassaridianMissionsEffective(args)
	if not bassaridianMissionsEnabled(args) then return false end
	local year = tonumber(args.year or args.psscyear) or 0
	local day = tonumber(args.day or args.dayofyear) or 0
	local startYear = tonumber(args.missionstartyear or args.missionStartYear) or BASSARIDIAN_MISSIONS_START_YEAR
	local startDay = tonumber(args.missionstartday or args.missionStartDay) or BASSARIDIAN_MISSIONS_START_DAY
	return isOnOrAfterPSSCDate(year, day, startYear, startDay)
end

local function hasBassaridianMission(args, loc)
	if not bassaridianMissionsEffective(args) then return false end
	return loc ~= nil
end

local function hasMajorBassaridianMission(args, loc)
	if not bassaridianMissionsEffective(args) then return false end
	return loc and majorBassaridianMissionLocalities[tostring(loc.code or "")] == true
end

-- Nysara Velai-specific probability modifiers
local function nysaraVelaiComplianceBoost(args)
	local v = tonumber(
		args.nysaravelaicomplianceboost or
		args.nysaraVelaiComplianceBoost or
		args.nysaracomplianceboost or
		args.nysaraComplianceBoost or
		args.ayscomplianceboost or
		args.aysComplianceBoost
	)
	if v == nil then v = 6 end
	return v
end

local function nysaraVelaiUnrestAdjustment(args)
	local reduction = tonumber(
		args.nysaravelaiunrestreduction or
		args.nysaraVelaiUnrestReduction or
		args.nysaraunrestreduction or
		args.nysaraUnrestReduction or
		args.aysunrestreduction or
		args.aysUnrestReduction
	)
	if reduction ~= nil then
		return -math.abs(reduction)
	end

	-- Legacy additive override retained for compatibility.
	local legacyBoost = tonumber(
		args.nysaravelaiunrestboost or
		args.nysaraVelaiUnrestBoost or
		args.nysaraunrestboost or
		args.nysaraUnrestBoost or
		args.aysunrestboost or
		args.aysUnrestBoost
	)
	if legacyBoost ~= nil then
		return legacyBoost
	end
	return -6
end

local function nysaraVelaiTradeBoost(args)
	local v = tonumber(
		args.nysaravelaitradeboost or
		args.nysaraVelaiTradeBoost or
		args.nysaratradeboost or
		args.nysaraTradeBoost or
		args.aystradeboost or
		args.aysTradeBoost
	)
	if v == nil then v = 3 end
	return v
end

local function nysaraVelaiAdjustedComplianceChance(args, loc, baseChance)
	local chance = clampChance(baseChance)
	if loc and tostring(loc.code or "") == "AYS" then
		chance = chance + nysaraVelaiComplianceBoost(args)
	end
	return clampChance(chance)
end

local function nysaraVelaiAdjustedUnrestChance(args, loc, baseChance)
	local chance = clampChance(baseChance)
	if loc and tostring(loc.code or "") == "AYS" then
		chance = chance + nysaraVelaiUnrestAdjustment(args)
	end
	return clampChance(chance)
end

local function nysaraVelaiAdjustedTradeChance(args, loc, baseChance)
	local chance = clampChance(baseChance)
	if loc and tostring(loc.code or "") == "AYS" then
		chance = chance + nysaraVelaiTradeBoost(args)
	end
	return clampChance(chance)
end

local function missionAdjustedComplianceChance(args, loc, baseChance)
	local chance = clampChance(baseChance)
	if hasBassaridianMission(args, loc) then
		chance = chance + (tonumber(args.missioncomplianceboost or args.missionComplianceBoost) or 1)
	end
	if hasMajorBassaridianMission(args, loc) then
		chance = chance + (tonumber(args.majormissioncomplianceboost or args.majorMissionComplianceBoost) or 2)
	end
	return clampChance(chance)
end

local function missionAdjustedUnrestChance(args, loc, baseChance)
	local chance = clampChance(baseChance)
	if hasBassaridianMission(args, loc) then
		chance = chance - (tonumber(args.missionunrestreduction or args.missionUnrestReduction) or 1)
	end
	return clampChance(chance)
end

local function bassaridianMissionsNotice(args)
	if not bassaridianMissionsEffective(args) then return "" end
	return "'''Bassaridian Missions acknowledged:''' [[Temple Bank of the Reformed Stripping Path|Temple Bank]]-run fortified mission compounds operate across the Southern Strait locality system, with major mission houses at [[Saruq Thyrsa]], [[Mirovia]], [[Nysara Velai]], [[Thal Lenaia]], and [[Selenarion]].<br>" ..
		"<small>From 55/2/53 PSSC onward, all locality rows receive -1 percentage point to unrest alerts and +1 percentage point to compliance observations. " ..
		"Major mission localities receive an additional +2 percentage points to compliance observations. " ..
		"Nysara Velai separately receives +6 percentage points to compliance-observation likelihood and -6 percentage points to unrest-alert likelihood, reflecting the stabilizing effect of the enlarged CKD presence, strengthened missionary institutions, protected terrace routes, and improving administrative cooperation across the eastern Snowholme approaches. Its former +3-point trade-signoff modifier is retained only for historical reproduction through 27/3/53 PSSC; no new agreements may be generated afterward. " ..
		"Mission guards are drawn from local Baratar recruits and Council of Kings Division rotations, while deployed units continue to route through [[Mylecia]] before staging locally.</small>"
end

-- Recurring adversarial-node tracking
local ADVERSARY_NODES_START_YEAR = 53
local ADVERSARY_NODES_START_DAY = 121

local recurringAdversaries = {
	KHADIR = {
		name = "[[Khadir Veyran]]",
		epithet = "Keeper of the Bromian Ledger",
		localities = { QSE = true, AYS = true, RUK = true, HAY = true },
		notes = {
			"Bromian Ledger intermediaries are suspected of delaying countersignatures without openly refusing Bassaridian review.",
			"Veyran-linked witnesses preserve older Maritime Markets custom as a rival source of commercial legitimacy.",
			"Broker-house clerks appear to be keeping disputed cargo identity ambiguous until General Port auditors withdraw.",
			"Warehouse notaries tied to the Bromian Ledger are suspected of turning routine paperwork into a jurisdictional dispute."
		},
		complianceNotes = {
			"Temple Bank auditors noted that this cooperation weakens the Bromian Ledger's claim that older broker custom remains the only trusted record.",
			"Local registry compliance was treated as useful evidence against Veyran-linked delay tactics.",
			"The observation was preserved as a small but meaningful challenge to Bromian Ledger influence in the pass-road economy."
		},
		tradeNotes = {
			"Temple Bank clerks flagged the sign-off as a possible counterweight to Khadir Veyran's older broker-credit network.",
			"The filing gives General Port auditors a lawful route around Bromian Ledger intermediaries.",
			"The agreement was preserved as evidence that local commercial authority could be recorded without Veyran's countersignature."
		}
	},
	SUYANA = {
		name = "[[Suyana Amaruq]]",
		epithet = "Black-Thread Suyana",
		localities = { QSE = true, AYS = true, THQ = true, HAY = true },
		notes = {
			"Black-Thread couriers are suspected of using ordinary household movement to mask route intelligence.",
			"Suyana-linked runners may have tested night-road inspection gaps before disappearing into ordinary market traffic.",
			"False pilgrims and guide-house messengers appear to have carried warning signals ahead of the audit lane.",
			"Temple Bank officers treated the incident as route-intelligence obstruction rather than ordinary smuggling."
		},
		complianceNotes = {
			"The observation was treated as a useful interruption of Black-Thread courier habits.",
			"Licensed guides helped separate ordinary passage from Suyana-linked courier movement.",
			"Temple Bank staff preserved the record as evidence that local mobility could be protected without unregistered courier screens."
		},
		tradeNotes = {
			"Temple Bank notes warned that Black-Thread couriers may attempt to test the new trade window through false-route traffic.",
			"The sign-off was paired with route-watch instructions because Suyana-linked couriers remained active near the upland approaches.",
			"Mission clerks treated the filing as useful, but not sufficient to end Black-Thread influence over informal passage."
		}
	}
}

local function adversaryNodesEnabled(args)
	return yn(
		args.adversarynodes or
		args.adversaryNodes or
		args.namedadversaries or
		args.namedAdversaries or
		args.adversarynotes or
		args.adversaryNotes,
		true
	)
end

local function adversaryNodesEffective(args)
	if not adversaryNodesEnabled(args) then return false end
	local year = tonumber(args.year or args.psscyear) or 0
	local day = tonumber(args.day or args.dayofyear) or 0
	local startYear = tonumber(args.adversarystartyear or args.adversaryStartYear) or ADVERSARY_NODES_START_YEAR
	local startDay = tonumber(args.adversarystartday or args.adversaryStartDay) or ADVERSARY_NODES_START_DAY
	return isOnOrAfterPSSCDate(year, day, startYear, startDay)
end

local function adversaryNoteChance(args, kind)
	kind = tostring(kind or "")
	if kind == "trade" then
		return clampChance(tonumber(args.tradeadversarychance or args.tradeAdversaryChance) or 22)
	elseif kind == "compliance" then
		return clampChance(tonumber(args.complianceadversarychance or args.complianceAdversaryChance) or 18)
	end
	return clampChance(tonumber(
		args.adversarychance or
		args.adversaryChance or
		args.unrestadversarychance or
		args.unrestAdversaryChance
	) or 35)
end

local function localityAllowsAdversary(loc, adv)
	if not adv then return false end
	if not loc then return true end
	local localities = adv.localities
	if not localities then return true end
	return localities[tostring(loc.code or "")] == true
end

local function candidateAdversaryCodes(profile, loc)
	local out = {}
	if profile and type(profile.adversaries) == "table" then
		for _, code in ipairs(profile.adversaries) do
			local adv = recurringAdversaries[code]
			if adv and localityAllowsAdversary(loc, adv) then
				table.insert(out, code)
			end
		end
	end
	if #out == 0 then
		for code, adv in pairs(recurringAdversaries) do
			if localityAllowsAdversary(loc, adv) then
				table.insert(out, code)
			end
		end
	end
	return out
end

local function adversaryNotePart(args, kind, seed, profile, loc)
	if not adversaryNodesEffective(args) then return "" end
	local chance = adversaryNoteChance(args, kind)
	local roll = pctFromSeed(seed, "adv-note-roll-" .. tostring(kind or "general")) + 1
	if roll > chance then return "" end

	local candidates = candidateAdversaryCodes(profile, loc)
	local code = pick(candidates, seed, "adv-note-code-" .. tostring(kind or "general"))
	local adv = recurringAdversaries[code]
	if not adv then return "" end

	local notes = adv.notes
	if tostring(kind or "") == "trade" and adv.tradeNotes then
		notes = adv.tradeNotes
	elseif tostring(kind or "") == "compliance" and adv.complianceNotes then
		notes = adv.complianceNotes
	end

	local note = pick(notes, seed, "adv-note-text-" .. tostring(kind or "general"))
	if not note then return "" end
	return "<br>'''Adversarial note:''' " .. adv.name .. " (''" .. adv.epithet .. "'') — " .. note
end

local function adversarialNodesNotice(args)
	if not adversaryNodesEffective(args) then return "" end
	return "'''Temple Bank adversarial-node tracking active:''' from 60/2/53 PSSC onward, occasional row-level notes may identify suspected influence associated with [[Khadir Veyran]] (''Keeper of the Bromian Ledger'') or [[Suyana Amaruq]] (''Black-Thread Suyana'').<br>" ..
		"<small>These notes are seeded and probabilistic. They do not appear in every unrest or compliance row; trade-signoff notes remain available only when reproducing historical dates through 27/3/53 PSSC. " ..
		"Use '''adversarynodes=no''' to disable them, '''adversarychance=35''' to adjust unrest-note frequency, '''complianceadversarychance=18''' to adjust compliance-note frequency, and '''tradeadversarychance=22''' only for historical trade-signoff rows.</small>"
end

-- Forced City/Node display
local forcedCityNodeText = "[[File:MyleciaFlabB.jpeg|20px]] [[Mylecia]]"

local function cleanHeaderLabel(line)
	local s = tostring(line or "")
	s = s:gsub("^%s*!+%s*", "")
	if s:find("|", 1, true) then
		local parts = mw.text.split(s, "|", true)
		s = parts[#parts] or s
	end
	s = s:gsub("<.->", "")
	s = s:gsub("%[%[[^%]|]+|([^%]]+)%]%]", "%1")
	s = s:gsub("%[%[([^%]]+)%]%]", "%1")
	s = s:gsub("&nbsp;", " ")
	s = s:gsub("%s*/%s*", "/")
	s = s:gsub("^%s+", ""):gsub("%s+$", "")
	return s:lower()
end

local cityNodeHeaderLabels = {
	["city"] = true,
	["node"] = true,
	["city/node"] = true,
	["city / node"] = true,
	["city or node"] = true,
	["home port"] = true,
	["homeport"] = true,
	["home city"] = true,
	["base city"] = true,
	["staging city"] = true
}

local function forceMyleciaCityNodeColumn(body, args)
	body = tostring(body or "")
	if yn(args.forcemylecia or args.forceMylecia or args.myleciacity or args.myleciaCity, true) == false then
		return body
	end
	if not body:find("{|", 1, true) then return body end

	local forcedText = args.forcecitytext or args.forceCityText or forcedCityNodeText
	local lines = mw.text.split(body, "\n", true)
	local out = {}
	local inTable = false
	local cityCol = nil
	local col = 0

	for _, line in ipairs(lines) do
		if line:match("^%s*{|") then
			inTable = true
			cityCol = nil
			col = 0
			table.insert(out, line)
		elseif inTable and line:match("^%s*!") then
			local raw = line:gsub("^%s*!+%s*", "")
			local headers = mw.text.split(raw, "!!", true)
			if #headers > 1 then
				for _, h in ipairs(headers) do
					col = col + 1
					if cityNodeHeaderLabels[cleanHeaderLabel("! " .. h)] then
						cityCol = col
					end
				end
			else
				col = col + 1
				if cityNodeHeaderLabels[cleanHeaderLabel(line)] then
					cityCol = col
				end
			end
			table.insert(out, line)
		elseif inTable and line:match("^%s*|%-") then
			col = 0
			table.insert(out, line)
		elseif inTable and cityCol and line:match("^%s*|[^}%-%+]") then
			local raw = line:gsub("^%s*|%s*", "")
			local cells = mw.text.split(raw, "||", true)
			if #cells > 1 then
				for i = 1, #cells do
					if i == cityCol then cells[i] = " " .. forcedText .. " " end
				end
				table.insert(out, "| " .. table.concat(cells, " || "))
			else
				col = col + 1
				if col == cityCol then
					table.insert(out, "| " .. forcedText)
				else
					table.insert(out, line)
				end
			end
		elseif inTable and line:match("^%s*|}") then
			inTable = false
			table.insert(out, line)
		else
			table.insert(out, line)
		end
	end
	return table.concat(out, "\n")
end

-- Hatch Ministry Home city / Current station swap
local function swapHatchHomeCityCurrentStation(body, args)
	body = tostring(body or "")
	if yn(args.swaphatchstation or args.swapHatchStation or args.swaphatchhomecity or args.swapHatchHomeCity, true) == false then
		return body
	end
	if not body:find("{|", 1, true) then return body end

	local lines = mw.text.split(body, "\n", true)
	local out = {}
	local inTable = false
	local homeCol = nil
	local stationCol = nil
	local col = 0

	for _, line in ipairs(lines) do
		if line:match("^%s*{|") then
			inTable = true
			homeCol = nil
			stationCol = nil
			col = 0
			table.insert(out, line)
		elseif inTable and line:match("^%s*!") then
			local raw = line:gsub("^%s*!+%s*", "")
			local headers = mw.text.split(raw, "!!", true)
			if #headers > 1 then
				for _, h in ipairs(headers) do
					col = col + 1
					local label = cleanHeaderLabel("! " .. h)
					if label == "home city" or label == "home" then
						homeCol = col
					elseif label == "current station" or label == "station" then
						stationCol = col
					end
				end
			else
				col = col + 1
				local label = cleanHeaderLabel(line)
				if label == "home city" or label == "home" then
					homeCol = col
				elseif label == "current station" or label == "station" then
					stationCol = col
				end
			end
			table.insert(out, line)
		elseif inTable and line:match("^%s*|%-") then
			col = 0
			table.insert(out, line)
		elseif inTable and homeCol and stationCol and line:match("^%s*|[^}%-%+]") then
			local raw = line:gsub("^%s*|%s*", "")
			local cells = mw.text.split(raw, "||", true)
			if #cells > 1 then
				if cells[homeCol] and cells[stationCol] then
					cells[homeCol], cells[stationCol] = cells[stationCol], cells[homeCol]
				end
				table.insert(out, "| " .. table.concat(cells, " || "))
			else
				col = col + 1
				table.insert(out, line)
			end
		elseif inTable and line:match("^%s*|}") then
			inTable = false
			table.insert(out, line)
		else
			table.insert(out, line)
		end
	end
	return table.concat(out, "\n")
end

-- Trade-agreement generation cutoff
-- The Nysara Velai sign-off on 27/3/53 PSSC concluded the locality-alignment phase.
-- Historical output through that date remains reproducible, but all dates from
-- 28/3/53 PSSC onward hard-return '-' in the Trade agreement column.
local TRADE_SIGNOFF_FINAL_YEAR = 53
local TRADE_SIGNOFF_FINAL_DAY = 149 -- 27/3/53 PSSC

local function tradeAgreementGenerationClosed(args)
	local year = tonumber(args.year or args.psscyear) or 0
	local day = tonumber(args.day or args.dayofyear) or 0

	if year > TRADE_SIGNOFF_FINAL_YEAR then
		return true
	end
	if year == TRADE_SIGNOFF_FINAL_YEAR and day > TRADE_SIGNOFF_FINAL_DAY then
		return true
	end
	return false
end

-- Cult sign-off list for Temple Bank trade agreements
local tradeSigningCults = {
	{ code = "UMB", label = "[[Noctis (Reformed Stripping Path)#Order of the Umbral Oracle|Order of the Umbral Oracle]]" },
	{ code = "GGS", label = "[[Chrysos (Reformed Stripping Path)#Guild of Golden Shadows|Guild of Golden Shadows]]" },
	{ code = "AZS", label = "[[Thalassa (Reformed Stripping Path)#Azure Sentinel Sect|Azure Sentinel Sect]]" },
	{ code = "HAR", label = "[[Micras (Reformed Stripping Path)#Harmony Sanctum|Harmony Sanctum]]" },
	{ code = "VIT", label = "[[Plateau (Reformed Stripping Path)#Sanctum Vitalis|Sanctum Vitalis]]" },
	{ code = "AUR", label = "[[Eos (Reformed Stripping Path)#Order of Aurora Mystica|Order of Aurora Mystica]]" },
	{ code = "DEL", label = "[[Sisera (Reformed Stripping Path)#Sanctum Delphica|Sanctum Delphica]]" },
	{ code = "CAT", label = "[[Cato (Reformed Stripping Path)#Rex Catonis|Rex Catonis]]" },
	{ code = "CON", label = "[[Lukedu (Reformed Stripping Path)#Accord Concordia|Accord Concordia]]" },
	{ code = "STY", label = "[[Styx (Reformed Stripping Path)#Mystery of the Stygian Veil|Mystery of the Stygian Veil]]" }
}

local tradeOutcomes = {
	"Cleared for General Port ledger review.",
	"Provisional admission recommended.",
	"Conditional trade window approved.",
	"Company charter accepted for corridor listing.",
	"Trade agreement filed through ordinary registry channels."
}

local function tradeAgreementCell(args, channel, rowNumber, loc)
	if tostring(channel or "") ~= "missionary" then return "-" end
	if not loc then return "-" end
	if tradeAgreementGenerationClosed(args) then return "-" end

	local chance = imperialSupportBoostedChance(
		args,
		loc,
		tonumber(args.tradechance or args.tradeChance) or 3,
		3
	)
	chance = nysaraVelaiAdjustedTradeChance(args, loc, chance)

	local year = tonumber(args.year or args.psscyear) or 0
	local day = tonumber(args.day or args.dayofyear) or 0
	local seed = tostring(args.seed or "") ..
		":SS-TEMPLE-TRADE-COL:" .. tostring(rowNumber or 0) ..
		":" .. tostring(loc.code or "GEN") ..
		":" .. tostring(year) ..
		":" .. tostring(day)

	local roll = pctFromSeed(seed, "roll") + 1
	if roll > chance then
		if yn(args.showTradeNoEvent or args.showtradenoevent, false) then return "No sign-off" end
		return "-"
	end

	local cult = pick(tradeSigningCults, seed, "cult")
	local outcome = pick(tradeOutcomes, seed, "outcome")
	if not cult then return "-" end

	local seq = (pctFromSeed(seed, "seq") % 20) + 1
	local tradeId
	if year > 0 and day > 0 then
		tradeId = string.format("GP-SS-%03d.%03d-%s-%02d", year, day, loc.code or "GEN", seq)
	else
		tradeId = string.format("GP-SS-%s-%02d", loc.code or "GEN", seq)
	end
	local signCode = string.format("%s-TA%02d", cult.code or "CUL", seq)
	local advNote = adversaryNotePart(args, "trade", seed, nil, loc)
	return "'''Trade sign-off'''<br>" ..
		"<small>" .. tradeId .. "</small><br>" ..
		(cult.label or "Cult sign-off recorded") .. "<br>" ..
		"<small>Code: '''" .. signCode .. "'''<br>" .. outcome .. advNote .. "</small>"
end

-- Rebellion / corridor unrest row column
local rebellionProfiles = {
	{ label = "Confederacy-adjacent courier screen", description = "False-route couriers testing inspection gaps.", adversaries = { "SUYANA" } },
	{ label = "Former Maritime Markets broker faction", description = "Old broker-house retainers resisting General Port paperwork.", adversaries = { "KHADIR" } },
	{ label = "Anti-registry dock syndicate", description = "Warehouse intermediaries opposing voucher and ledger discipline.", adversaries = { "KHADIR" } },
	{ label = "False-proclamation circle", description = "Pamphlet readers circulating forged civic orders.", adversaries = { "KHADIR", "SUYANA" } },
	{ label = "Route-barricade committee", description = "Agitators obstructing lawful inspection lanes.", adversaries = { "SUYANA" } },
	{ label = "Dispossessed-sympathetic quay cell", description = "Waterfront cell copying Confederacy-style courier habits.", adversaries = { "SUYANA" } },
	{ label = "Illicit ritual-cargo and medical-transfer exploiters", description = "Handlers using illness, mourning, ritual cargo, or shrine protection to delay inspection.", adversaries = { "SUYANA" } },
	{ label = "Bromian Ledger witness screen", description = "Broker-linked witnesses preserving conflicting older records against General Port review.", adversaries = { "KHADIR" } }
}

local rebellionTriggers = {
	"Forged levy notice.",
	"Masked speakers redirected traffic.",
	"Missing seals and altered registry slips.",
	"Crowd pressure over bonded cargo.",
	"Tampered signal schedule.",
	"Conflicting route orders.",
	"Coordinated paper strike.",
	"Anti-Bassaridian chant movement.",
	"Repeated courier handoffs.",
	"Matched false manifests.",
	"False medical-transfer exemption.",
	"Unreconciled caravan lodging roll.",
	"Guide-house witness contradiction.",
	"Older Maritime Markets clearance invoked."
}

local rebellionActions = {
	"CKD cordon and evidence hold.",
	"Temple rumor-control desk opened.",
	"Ledgers and copied seals sealed.",
	"Privateer stand-off posture.",
	"Pass papers reissued.",
	"Lawful cargo separated.",
	"Missionary mediation opened.",
	"Corrected signal notice issued.",
	"Temporary General Port audit lane opened.",
	"Incident classified as contained unrest.",
	"Guide-license review opened.",
	"Medical-transfer custody ledger corrected.",
	"Broker-house witnesses summoned for countersignature.",
	"Night-road registry temporarily frozen."
}

local rebellionRisks = { "Low", "Moderate", "High", "Contained", "Escalating" }
local rebellionAlertExcludedLocalities = { MIR = true, SAR = true, THQ = true }

local function isRebellionAlertExcluded(loc)
	if not loc then return false end
	return rebellionAlertExcludedLocalities[tostring(loc.code or "")] == true
end

local function rebellionAlertCell(args, channel, rowNumber, loc)
	if not loc then return "-" end
	if isRebellionAlertExcluded(loc) then return "-" end

	local baseChance = tonumber(args.rebellionchance or args.rebellionChance or args.unrestchance or args.unrestChance) or 6
	local chance = missionAdjustedUnrestChance(args, loc, baseChance)
	chance = nysaraVelaiAdjustedUnrestChance(args, loc, chance)

	local year = tonumber(args.year or args.psscyear) or 0
	local day = tonumber(args.day or args.dayofyear) or 0
	local seed = tostring(args.seed or "") ..
		":SS-REBELLION-COL:" .. tostring(channel or "") ..
		":" .. tostring(rowNumber or 0) ..
		":" .. tostring(loc.code or "GEN") ..
		":" .. tostring(year) ..
		":" .. tostring(day)

	local roll = pctFromSeed(seed, "roll") + 1
	if roll > chance then
		if yn(args.showRebellionNoEvent or args.showrebellionnoevent or args.showUnrestNoEvent or args.showunrestnoevent, false) then
			return "No unrest"
		end
		return "-"
	end

	local profile = pick(rebellionProfiles, seed, "profile")
	local trigger = pick(rebellionTriggers, seed, "trigger")
	local action = pick(rebellionActions, seed, "action")
	local risk = pick(rebellionRisks, seed, "risk")
	if not profile then return "-" end

	local seq = (pctFromSeed(seed, "seq") % 20) + 1
	local eventId
	if year > 0 and day > 0 then
		eventId = string.format("SS-RB-%03d.%03d-%s-%02d", year, day, loc.code or "GEN", seq)
	else
		eventId = string.format("SS-RB-%s-%02d", loc.code or "GEN", seq)
	end
	local advNote = adversaryNotePart(args, "unrest", seed, profile, loc)
	return "'''Unrest alert'''<br>" ..
		"<small>" .. eventId .. "</small><br>" ..
		"'''Profile:''' " .. profile.label .. "<br>" ..
		"<small>" .. profile.description .. "<br>" ..
		"'''Trigger:''' " .. trigger .. "<br>" ..
		"'''Risk:''' " .. risk .. "<br>" ..
		"'''Response:''' " .. action .. advNote .. "</small>"
end

-- Compliance observed / minor positive row column
local complianceProfiles = {
	{ label = "Inspection cooperation", description = "Local carriers complied with inspection sequencing without requiring escalation.", adversaries = { "SUYANA" } },
	{ label = "Ledger correction", description = "Route clerks corrected incomplete or inconsistent paperwork before formal penalty.", adversaries = { "KHADIR" } },
	{ label = "Crowd dispersal", description = "Local stewards dispersed a gathering before it became an obstruction.", adversaries = { "SUYANA" } },
	{ label = "Guide assistance", description = "Licensed guides helped separate lawful traffic from suspect courier movement.", adversaries = { "SUYANA" } },
	{ label = "Cargo separation", description = "Bonded cargo was voluntarily separated for review without disrupting ordinary passage.", adversaries = { "KHADIR" } },
	{ label = "Rumor-control compliance", description = "Temple notices were accepted locally and hostile rumors lost momentum.", adversaries = { "KHADIR", "SUYANA" } },
	{ label = "Privateer signal compliance", description = "Vessels accepted stand-off or hold-and-release signals without resistance.", adversaries = { "SUYANA" } },
	{ label = "Registry cooperation", description = "Local registrars preserved names, seals, and witness records for later review.", adversaries = { "KHADIR" } },
	{ label = "Medical-transfer ledger cooperation", description = "Clinic escorts preserved patient custody records without accepting false sacred exemptions.", adversaries = { "SUYANA" } }
}

local complianceOutcomes = {
	"Minor positive compliance noted.",
	"Recorded as a stabilizing local action.",
	"Accepted as offsetting evidence against wider noncompliance.",
	"Filed as a documented good-faith response.",
	"Preserved for future compliance comparison.",
	"Marked as below trade-agreement threshold but operationally helpful."
}

local function complianceObservedCell(args, channel, rowNumber, loc)
	if not loc then return "-" end
	local baseChance = tonumber(args.compliancechance or args.complianceChance or args.observedchance or args.observedChance) or 8
	local chance = missionAdjustedComplianceChance(args, loc, baseChance)
	chance = imperialSupportBoostedChance(args, loc, chance, 10)
	chance = nysaraVelaiAdjustedComplianceChance(args, loc, chance)

	local year = tonumber(args.year or args.psscyear) or 0
	local day = tonumber(args.day or args.dayofyear) or 0
	local seed = tostring(args.seed or "") ..
		":SS-COMPLIANCE-COL:" .. tostring(channel or "") ..
		":" .. tostring(rowNumber or 0) ..
		":" .. tostring(loc.code or "GEN") ..
		":" .. tostring(year) ..
		":" .. tostring(day)

	local roll = pctFromSeed(seed, "roll") + 1
	if roll > chance then
		if yn(args.showComplianceNoEvent or args.showcompliancenoevent, false) then return "No observation" end
		return "-"
	end

	local profile = pick(complianceProfiles, seed, "profile")
	local outcome = pick(complianceOutcomes, seed, "outcome")
	if not profile then return "-" end

	local seq = (pctFromSeed(seed, "seq") % 20) + 1
	local eventId
	if year > 0 and day > 0 then
		eventId = string.format("SS-CO-%03d.%03d-%s-%02d", year, day, loc.code or "GEN", seq)
	else
		eventId = string.format("SS-CO-%s-%02d", loc.code or "GEN", seq)
	end
	local advNote = adversaryNotePart(args, "compliance", seed, profile, loc)
	return "'''Compliance observed'''<br>" ..
		"<small>" .. eventId .. "</small><br>" ..
		"'''Profile:''' " .. profile.label .. "<br>" ..
		"<small>" .. profile.description .. "<br>" ..
		"'''Outcome:''' " .. outcome .. advNote .. "</small>"
end

-- Row-column insertion helper
local function addCorridorColumns(body, args, channel)
	body = tostring(body or "")
	if not body:find("{|", 1, true) then return body end

	local showLocalityColumn = yn(args.rowlocalities or args.localities or args.showlocalities, true)
	local showTradeColumn = yn(args.tradecolumn or args.tradecolumns or args.showtradecolumn, true)
	local showComplianceColumn = yn(args.compliancecolumn or args.compliancecolumns or args.observedcolumn or args.showcompliancecolumn, true)
	local showRebellionColumn = yn(args.rebellioncolumn or args.rebellioncolumns or args.unrestcolumn or args.showrebellioncolumn, true)
	if not showLocalityColumn and not showTradeColumn and not showComplianceColumn and not showRebellionColumn then
		return body
	end

	local lines = mw.text.split(body, "\n", true)
	local out = {}
	local inTable = false
	local headerInserted = false
	local rowNumber = 0
	local localityState = newLocalityAssignmentState(args, channel)

	for _, line in ipairs(lines) do
		if line:match("^%s*{|") then
			inTable = true
			headerInserted = false
			table.insert(out, line)
		elseif inTable and not headerInserted and line:match("^%s*!") then
			if showLocalityColumn then table.insert(out, "! Locality focus") end
			if showTradeColumn then table.insert(out, "! Trade agreement") end
			if showComplianceColumn then table.insert(out, "! Compliance observed") end
			if showRebellionColumn then table.insert(out, "! Rebellion alert") end
			headerInserted = true
			table.insert(out, line)
		elseif inTable and line:match("^%s*|%-") then
			rowNumber = rowNumber + 1
			local loc = rowLocalityData(args, channel, rowNumber, localityState)
			table.insert(out, line)
			if showLocalityColumn then table.insert(out, "| " .. rowLocalityText(loc)) end
			if showTradeColumn then table.insert(out, "| " .. tradeAgreementCell(args, channel, rowNumber, loc)) end
			if showComplianceColumn then table.insert(out, "| " .. complianceObservedCell(args, channel, rowNumber, loc)) end
			if showRebellionColumn then table.insert(out, "| " .. rebellionAlertCell(args, channel, rowNumber, loc)) end
		elseif inTable and line:match("^%s*|}") then
			inTable = false
			table.insert(out, line)
		else
			table.insert(out, line)
		end
	end
	return table.concat(out, "\n")
end

-- Main Southern Strait-only view
function p.makeTable(frame)
	local args = normalizeArgsDate((frame and frame.args) or {})
	local showIntro = yn(args.intro, false)
	local showTitle = yn(args.showtitle or args.titleline, false)
	local showLegend = yn(args.legend or args.showlegend, false)
	local collapseSections = yn(args.collapsible, true)
	local startCollapsed = yn(args.collapsed, true)
	local includeWar = yn(args.war or args.warleague, true)
	local includeHatch = yn(args.hatch or args.hatchministry, true)
	local includeMission = yn(args.missionary or args.templebank, true)
	local year = args.year or args.psscyear
	local day = args.day or args.dayofyear
	local title = args.title or "Southern Strait Corridor Daily Operations"
	local label = dateLabel(args)
	local out = {}

	if showTitle then table.insert(out, "==" .. title .. "==") end
	if showIntro then
		table.insert(out, string.format(
			"''Southern Strait-only operational display for %s, limited to Mylecian Southern Strait corridor entries.''",
			label
		))
		table.insert(out, "")
		table.insert(out,
			"This display combines Council of Kings deployments, Hatch Ministry privateer activity, Temple Bank missionary operations, row-level Southern Strait locality focus columns, row-level compliance observations, and row-level rebellion-type unrest alerts while displaying the operational City/Node as Mylecia. Historical Temple Bank trade sign-offs remain reproducible through 27/3/53 PSSC, but all later Trade agreement cells display '-'. Imperial Federation, Bassaridian Mission, capped-locality, CKD reinforcement concentration, and Temple Bank adversarial-node modifiers are applied where effective."
		)
	end

	local ifSupportNotice = imperialFederationSupportNotice(args)
	if ifSupportNotice ~= "" then
		table.insert(out, ifSupportNotice)
		table.insert(out, "")
	end

	local missionNotice = bassaridianMissionsNotice(args)
	if missionNotice ~= "" then
		table.insert(out, missionNotice)
		table.insert(out, "")
	end

	local adversaryNotice = adversarialNodesNotice(args)
	if adversaryNotice ~= "" then
		table.insert(out, adversaryNotice)
		table.insert(out, "")
	end

	if includeWar then
		local warArgs = {
			year = year,
			day = day,
			rows = args.warrows or args.rows or "24",
			scanrows = args.warscanrows or args.scanrows or "160",
			showlegend = showLegend and "yes" or "no",
			flagsize = args.flagsize or "20",
			zone = "SouthernStrait",
			division = "Council of Kings Division"
		}
		if args.seed and tostring(args.seed) ~= "" then warArgs.seed = args.seed end
		local _, body = safeCall("Module:WarLeagueDivisionOpsBVR", "makeTable", warArgs)
		body = forceMyleciaCityNodeColumn(body, args)
		body = addCorridorColumns(body, args, "war")
		table.insert(out, hr())
		table.insert(out, section("Council of Kings Southern Strait deployments", body, collapseSections, startCollapsed))
	end

	if includeHatch then
		local hatchArgs = {
			year = year,
			day = day,
			legend = showLegend and "yes" or "no",
			zone = "SouthernStrait"
		}
		if args.captain and tostring(args.captain) ~= "" then hatchArgs.captain = args.captain end
		local _, body = safeCall("Module:HatchMinistryDailyOps", "dailyReport", hatchArgs)
		body = forceMyleciaCityNodeColumn(body, args)
		body = swapHatchHomeCityCurrentStation(body, args)
		body = addCorridorColumns(body, args, "hatch")
		table.insert(out, hr())
		table.insert(out, section("Hatch Ministry Southern Strait privateer operations", body, collapseSections, startCollapsed))
	end

	if includeMission then
		local missionaryArgs = {
			year = year,
			day = day,
			region = "Haifan",
			showlegend = showLegend and "yes" or "no",
			includeThreat = args.includeThreat or args.includethreat or "no",
			showEcon = args.showEcon or args.showecon or "no"
		}
		if args.missionarylimit and tostring(args.missionarylimit) ~= "" then
			missionaryArgs.limit = args.missionarylimit
		elseif args.limit and tostring(args.limit) ~= "" then
			missionaryArgs.limit = args.limit
		end
		local _, body = safeCall("Module:MissionaryDailyOpsBVR", "makeTable", missionaryArgs)
		body = forceMyleciaCityNodeColumn(body, args)
		body = addCorridorColumns(body, args, "missionary")
		table.insert(out, hr())
		table.insert(out, section("Temple Bank Southern Strait missionary operations", body, collapseSections, startCollapsed))
	end

	if showLegend then
		local legendBody = table.concat({
			"* '''Council of Kings Southern Strait deployments''' show only Council of Kings Division War League rows for the Southern Strait corridor.",
			"* '''Hatch Ministry Southern Strait privateer operations''' show Southern Strait privateer rows.",
			"* '''Temple Bank Southern Strait missionary operations''' show Haifan Bassaridian missionary rows, but the displayed City/Node is forced to Mylecia in this wrapper.",
			"* '''City/Node display''' is forced to [[File:MyleciaFlabB.jpeg|20px]] [[Mylecia]] for War League, Hatch Ministry, and Temple Bank rows.",
			"* '''Locality focus''' columns assign one extended Southern Strait, Eastern Mykonos Desert, or eastern Snowholme foothill settlement to each generated row when row-level localities are enabled.",
			"* '''CKD reinforcement at Nysara Velai''' assigns six War League locality rows there by default, representing the earlier three deployments plus three additional CKD deployments.",
			"* '''CKD reinforcement at Selenarion''' assigns two War League locality rows there by default, representing the earlier deployment plus one additional CKD deployment.",
			"* '''Hatch Ministry and Temple Bank locality targets''' remain at three Nysara Velai rows and one Selenarion row per section by default; the CKD reinforcement does not automatically increase those services.",
			"* '''Other capped presence localities''' are [[Mirovia]], [[Saruq Thyrsa]], and [[Thal Lenaia]]. Each may appear no more than once per section/channel.",
			"* '''Nysara Velai chance modifiers''' add +6 percentage points to compliance-observation likelihood and subtract 6 percentage points from unrest-alert likelihood. Its former +3-point trade-signoff modifier applies only to historical dates through 27/3/53 PSSC.",
			"* '''Trade agreement generation is closed''' from 28/3/53 PSSC onward. All channels display '''-''' in that column after the final Nysara Velai agreement; Temple Bank sign-offs remain reproducible only for historical dates through 27/3/53 PSSC.",
			"* '''Compliance observed''' columns show minor positive local behavior below the level of a formal trade agreement.",
			"* '''Rebellion alert''' columns show rare row-level contained unrest events such as forged proclamations, broker-cell activity, route barricades, false orders, ritual-cargo abuse, medical-transfer exploitation, or Dispossessed-adjacent courier behavior.",
			"* '''Mirovia''', '''Saruq Thyrsa''', and '''Thal Lenaia''' are hard-excluded from Rebellion Alert results; their Rebellion Alert cells always display '''-''', even when '''rebellionchance=100''' is used for testing.",
			"* '''Recurring adversarial nodes''' apply from 60/2/53 PSSC by default. Eligible rows may occasionally mention [[Khadir Veyran]] or [[Suyana Amaruq]] as suspected influence, but the notes are not guaranteed to appear.",
			"* '''Khadir Veyran''' notes are weighted toward broker factions, Bromian Ledger witness screens, anti-registry dock activity, cargo ambiguity, ledger correction, and trade-signoff counterweight language.",
			"* '''Suyana Amaruq''' notes are weighted toward courier screens, route barricades, false-pilgrim or guide-house movement, medical-transfer exploitation, and Black-Thread route-intelligence behavior.",
			"* '''Adversarial note frequency''' defaults to 35 percent for unrest alerts and 18 percent for compliance observations. The 22-percent trade-signoff note rate applies only to historical trade rows through 27/3/53 PSSC.",
			"* '''Imperial Federation support''' applies from 112/53 PSSC by default and adds +10 percentage points to compliance observations for Saruq Thyrsa, Mirovia, and Rumi-Kefaya. Its former +3-point trade-signoff effect is historical only and cannot generate agreements after 27/3/53 PSSC.",
			"* '''Bassaridian Missions support''' applies from 55/2/53 PSSC by default. It reduces unrest-alert chance by 1 percentage point in all locality rows and increases compliance-observation chance by 1 percentage point in all locality rows.",
			"* '''Major Bassaridian Missions''' at Saruq Thyrsa, Mirovia, Nysara Velai, Thal Lenaia, and Selenarion receive an additional +2 percentage points to compliance observations.",
			"* Use '''compliancechance=100''' and '''rebellionchance=100''' for testing. '''tradechance=100''' affects only historical dates through 27/3/53 PSSC and cannot override the post-agreement cutoff.",
			"* Use '''warnysaravelaitarget=6''' to change only the War League / CKD Nysara Velai target.",
			"* Use '''warselenariontarget=2''' to change only the War League / CKD Selenarion target.",
			"* Use '''nysaravelaitarget=3''' or '''selenariontarget=1''' to override the corresponding target in every section/channel.",
			"* Use '''nysaravelaioverfill=yes''' to allow Nysara Velai to exceed its section target after the priority rows are assigned.",
			"* Use '''nysaravelaicomplianceboost=6''' and '''nysaravelaiunrestreduction=6''' to change the active Nysara Velai modifiers. '''nysaravelaitradeboost=3''' is retained solely for historical reproduction through 27/3/53 PSSC. The older '''nysaravelaiunrestboost=''' parameter remains available as an additive legacy override.",
			"* Use '''adversarynodes=no''' to disable named adversarial notes.",
			"* Use '''adversarychance=35''' to change the default unrest-alert adversarial note chance.",
			"* Use '''complianceadversarychance=18''' to change the default compliance-observation adversarial note chance.",
			"* Use '''tradeadversarychance=22''' only to change adversarial-note frequency in historical Temple Bank trade-signoff rows through 27/3/53 PSSC.",
			"* Use '''adversarystartyear=53''' and '''adversarystartday=121''' to change the default 60/2/53 PSSC start date for named adversarial-node tracking.",
			"* Use '''missionsupport=no''' to disable Bassaridian Missions modifiers for testing.",
			"* Use '''imperialsupport=no''' to disable Imperial Federation support modifiers for testing.",
			"* Use '''forcemylecia=no''' only if the wrapper should temporarily show the original source-module City/Node values."
		}, "\n")
		table.insert(out, hr())
		table.insert(out, section("Combined legend", legendBody, collapseSections, startCollapsed))
	end

	return table.concat(out, "\n")
end

-- Shortcut views
function p.southernStrait(frame)
	local args = (frame and frame.args) or {}
	args.title = args.title or "Southern Strait Corridor Daily Operations"
	return p.makeTable({ args = args })
end

function p.warOnly(frame)
	local args = (frame and frame.args) or {}
	args.hatch = "no"
	args.missionary = "no"
	args.war = "yes"
	args.title = args.title or "War League Southern Strait Daily Operations"
	return p.makeTable({ args = args })
end

function p.hatchOnly(frame)
	local args = (frame and frame.args) or {}
	args.war = "no"
	args.missionary = "no"
	args.hatch = "yes"
	args.title = args.title or "Hatch Ministry Southern Strait Daily Operations"
	return p.makeTable({ args = args })
end

function p.missionaryOnly(frame)
	local args = (frame and frame.args) or {}
	args.war = "no"
	args.hatch = "no"
	args.missionary = "yes"
	args.title = args.title or "Temple Bank Southern Strait Missionary Daily Operations"
	return p.makeTable({ args = args })
end

return p
Retrieved from "https://micras.org/wiki/index.php?title=Module:SouthernStraitCorridorOps&oldid=410883"