feat(events): a trigger can start a run
Rust PLAN_REDESIGNS §14.3.12 (D370), stage 9 of §14.3. A definition's published version may carry `starts`: a trigger, a condition and a cooldown. A matching firing creates a run of it, now. - spec: `starts` validated by the phase gate's own function (same grammar, same dormant rule; a dormant start refuses publish), a cooldown from 0m to 7d (30m default), at most ten, event.* refused. - events/starts.js: the emit path's third subscriber, beside dispatch and the gate observer. An unverified version starts nothing; one run at a time per definition and the cooldown are one conditional UPDATE on the new event_trigger_starts table; the occurrence key makes one firing reported twice one run. Ignored firings are counted by why. - event_runs.origin: the firing (trigger, label, time, subject, matched condition, declared variables), also on the run.created audit line. - Editor: a "Started by the game" panel using the gate's condition builder, with the ignored-firings line. Run console: "Started because ... fired". - No module contract change and no MODULE_API bump. Tests: eventStarts (server 21, client 8); eventRunnerSql +7 against a real MariaDB (75/75); Module-uo proof on uo.champ.boss_up against the dev database. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY
This commit is contained in:
@@ -34,6 +34,8 @@ const activity = require('../../../model/activity/activity.model')
|
||||
const settingsDb = require('../../../model/events/eventActionSettings.db')
|
||||
const authorize = require('../../../events/authorize')
|
||||
const price = require('../../../events/price')
|
||||
const starts = require('../../../events/starts')
|
||||
const triggerStartsDb = require('../../../model/events/eventTriggerStarts.db')
|
||||
|
||||
const asId = (raw) => {
|
||||
const n = Number(raw)
|
||||
@@ -86,6 +88,9 @@ const shapeDefinition = (d) => ({
|
||||
const shapeEditable = async (row) => ({
|
||||
...shapeDefinition(row),
|
||||
draftAhead: await definitions.draftAhead(row),
|
||||
// What its trigger starts have done lately (D370): the last run one started
|
||||
// and the firings ignored since, by why. Null until a trigger first tries.
|
||||
triggerStarts: starts.describeState(await triggerStartsDb.forDefinition(row.id)),
|
||||
})
|
||||
|
||||
const shapeRun = (r) => ({
|
||||
@@ -105,6 +110,10 @@ const shapeRun = (r) => ({
|
||||
concurrencyKey: r.concurrency_key,
|
||||
params: r.params,
|
||||
rehearsal: r.rehearsal,
|
||||
// What started it, when a game firing did (D370): the trigger, when, its
|
||||
// subject, the condition it matched and its declared variables. Null for a
|
||||
// run started by hand or by the schedule.
|
||||
origin: r.origin || null,
|
||||
startedAt: r.started_at,
|
||||
endedAt: r.ended_at,
|
||||
// When the results table was ranked and published (Phase 10). On the LIST as
|
||||
@@ -223,6 +232,9 @@ exports.catalog = (_req, res) => {
|
||||
defaultBudgetMs: registries.DEFAULT_BUDGET_MS,
|
||||
maxAdvanceCount: spec.MAX_ADVANCE_COUNT,
|
||||
maxAfterSeconds: spec.MAX_AFTER_SECONDS,
|
||||
// A definition's `starts` (D370): how many, and the cooldown's ceiling.
|
||||
maxStarts: spec.MAX_STARTS,
|
||||
maxCooldownSeconds: spec.MAX_COOLDOWN_SECONDS,
|
||||
},
|
||||
})
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user