@aperant/framework 0.6.2

package/dist/cli/commands/effects.mjs

@@ -0,0 +1,385 @@
+/**
+ * commands/effects.mjs — pending-effects outbox (record/list/ack/drain/clear) (C29).
+ *
+ * The outbox is the low-volume authoritative event queue: agents append
+ * structured entries, a drainer replays them into canonical apt-tools paths.
+ * Storage: .aperant/pending-effects.jsonl (one JSON entry per line).
+ * Concurrency: every read/write goes through withFileLock on the file itself.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { findMilestoneScopeGlobal, loadRoadmapForScope } from '../roadmap/io.mjs';
+import { applyLifecyclePhaseSideEffect } from '../roadmap/lifecycle.mjs';
+import { parseFlags } from '../util/args.mjs';
+import { withFileLock } from '../util/fs-lock.mjs';
+import { err, ok, rawText } from '../util/result.mjs';
+function effectsPath(projectDir) {
+    return join(resolve(projectDir), '.aperant', 'pending-effects.jsonl');
+}
+function readEffects(filePath) {
+    if (!existsSync(filePath))
+        return [];
+    const raw = readFileSync(filePath, 'utf-8');
+    const out = [];
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            out.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Skip corrupt lines silently — record/ack rewrite the file so
+            // corruption self-heals on the next mutation.
+        }
+    }
+    return out;
+}
+function writeEffects(filePath, entries) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    const body = entries.map((e) => JSON.stringify(e)).join('\n');
+    const tmpPath = filePath + '.tmp.' + process.pid;
+    writeFileSync(tmpPath, entries.length === 0 ? '' : body + '\n', 'utf-8');
+    renameSync(tmpPath, filePath);
+}
+function generateEffectId() {
+    const ts = Date.now().toString(36);
+    const rand = Math.random().toString(36).slice(2, 8);
+    return `ef-${ts}-${rand}`;
+}
+export function cmdEffects(subcommand, projectDir, extraArgs) {
+    if (!subcommand)
+        return err('Usage: apt-tools effects <record|list|ack|drain|pending-count|clear> <project-dir> [flags]');
+    if (!projectDir)
+        return err('Usage: apt-tools effects ' + subcommand + ' <project-dir> [flags]');
+    const filePath = effectsPath(projectDir);
+    const flags = parseFlags(extraArgs);
+    switch (subcommand) {
+        case 'record': {
+            const op = flags.get('op');
+            const agent = flags.get('agent');
+            const mode = flags.get('mode') || '';
+            const affectsRaw = flags.get('affects') || '';
+            const contextRaw = flags.get('context') || '';
+            if (!op)
+                return err('Required: --op <operation-name>');
+            if (!agent)
+                return err('Required: --agent <agent-type>');
+            const affects = affectsRaw
+                ? affectsRaw
+                    .split(',')
+                    .map((s) => s.trim())
+                    .filter(Boolean)
+                : [];
+            let context = {};
+            if (contextRaw) {
+                try {
+                    context = JSON.parse(contextRaw);
+                }
+                catch (e) {
+                    return err(`Invalid JSON for --context: ${e.message}`);
+                }
+            }
+            const entry = {
+                id: generateEffectId(),
+                op,
+                agent,
+                mode,
+                affects,
+                context,
+                created_at: new Date().toISOString(),
+                attempts: 0,
+            };
+            withFileLock(filePath, () => {
+                const entries = readEffects(filePath);
+                entries.push(entry);
+                writeEffects(filePath, entries);
+            }, { projectRoot: resolve(projectDir) });
+            return ok({ status: 'ok', command: 'effects-record', id: entry.id, entry });
+        }
+        case 'list': {
+            const format = flags.get('format') || 'text';
+            const entries = withFileLock(filePath, () => readEffects(filePath), {
+                projectRoot: resolve(projectDir),
+            });
+            if (format === 'json') {
+                return ok({ status: 'ok', command: 'effects-list', count: entries.length, entries });
+            }
+            // Raw-text path: build the human-readable string and route through
+            // wrap()'s rawText shape (subtask 15) — no JSON envelope wrapper.
+            // (Subtask 20: replaces the legacy `process.stdout.write + return
+            // undefined` pattern that depended on wrap()'s now-deleted
+            // legacy-tolerance branch.)
+            let text;
+            if (entries.length === 0) {
+                text = 'No pending effects.\n';
+            }
+            else {
+                const lines = [`${entries.length} pending effect(s):`, ''];
+                for (const e of entries) {
+                    lines.push(`  ${e.id}`);
+                    lines.push(`    op:      ${e.op}`);
+                    lines.push(`    agent:   ${e.agent}`);
+                    if (e.mode)
+                        lines.push(`    mode:    ${e.mode}`);
+                    if (e.affects.length)
+                        lines.push(`    affects: ${e.affects.join(', ')}`);
+                    lines.push(`    created: ${e.created_at}`);
+                    lines.push('');
+                }
+                text = `${lines.join('\n')}`;
+            }
+            return rawText(text, 0);
+        }
+        case 'pending-count': {
+            const entries = withFileLock(filePath, () => readEffects(filePath), {
+                projectRoot: resolve(projectDir),
+            });
+            return ok({ status: 'ok', command: 'effects-pending-count', count: entries.length });
+        }
+        case 'ack': {
+            const id = flags.get('id');
+            if (!id)
+                return err('Required: --id <effect-id>');
+            let removed = null;
+            let unknown = false;
+            withFileLock(filePath, () => {
+                const entries = readEffects(filePath);
+                const idx = entries.findIndex((e) => e.id === id);
+                if (idx === -1) {
+                    // Tolerate unknown ids so drain retries and concurrent
+                    // drainers are safe. The caller pattern-matches on
+                    // status:ok and can inspect `removed`/`note` to detect
+                    // the no-op.
+                    unknown = true;
+                    return;
+                }
+                removed = entries.splice(idx, 1)[0];
+                writeEffects(filePath, entries);
+            }, { projectRoot: resolve(projectDir) });
+            if (unknown) {
+                return ok({
+                    status: 'ok',
+                    command: 'effects-ack',
+                    id,
+                    removed: null,
+                    note: 'unknown-id',
+                });
+            }
+            return ok({ status: 'ok', command: 'effects-ack', id, removed });
+        }
+        case 'clear': {
+            withFileLock(filePath, () => writeEffects(filePath, []), { projectRoot: resolve(projectDir) });
+            return ok({ status: 'ok', command: 'effects-clear' });
+        }
+        case 'drain': {
+            const targetDir = resolve(projectDir);
+            const dryRun = extraArgs.includes('--dry-run');
+            const verbose = extraArgs.includes('--verbose');
+            const limitRaw = flags.get('limit');
+            const limit = limitRaw ? Math.max(0, parseInt(limitRaw, 10) || 0) : 0;
+            // ── Op contract (authoritative, pure JS state machine) ───────────
+            // Every op lives in one of three buckets:
+            //   - ack-only:     no mutation, drop from queue
+            //   - phase-trans:  (now empty) — lifecycle phase transitions moved
+            //                   to `task update --lifecycle-phase` and `task
+            //                   close --verdict approved`, which call the shared
+            //                   `applyLifecyclePhaseSideEffect` helper inline.
+            //   - decision:     append to decisions ledger
+            // The unknown-op ack-only fallback below silently absorbs any
+            // legacy `task.*.start` / `task.*.complete` entries left in an
+            // in-flight queue on upgrade, so this change is forward-compatible.
+            const ACK_ONLY_OPS = new Set(['roadmap.render']);
+            const PHASE_TRANSITIONS = {};
+            const transitions = [];
+            const commits = [];
+            let drained = 0;
+            let failed = 0;
+            let parked = 0;
+            function logv(msg) {
+                if (verbose)
+                    process.stderr.write(`[effects-drain] ${msg}\n`);
+            }
+            function resolveScopeForEntry(entry) {
+                const ctx = entry.context || {};
+                if (ctx.scope)
+                    return ctx.scope;
+                if (ctx.milestone_id)
+                    return findMilestoneScopeGlobal(targetDir, ctx.milestone_id);
+                return null;
+            }
+            function applyPhaseTransition(entry, spec) {
+                const ctx = entry.context || {};
+                const scope = resolveScopeForEntry(entry);
+                if (!scope) {
+                    logv(`  ${entry.op}: no scope (missing linkage) — no-op`);
+                    return null;
+                }
+                if (!ctx.milestone_id || !ctx.phase_id) {
+                    logv(`  ${entry.op}: missing milestone_id/phase_id — no-op`);
+                    return null;
+                }
+                // Delegate to the shared helper. It mirrors the legacy behavior —
+                // from-state guard, saveRoadmapForScope, syncRoadmapInProcess — and
+                // returns null on any no-op branch. We just add verbose logging
+                // around the delegation so `--verbose` drains keep reading like the
+                // old inlined flow.
+                const task = {
+                    scope,
+                    milestone_id: ctx.milestone_id,
+                    phase_id: ctx.phase_id,
+                };
+                const result = applyLifecyclePhaseSideEffect(targetDir, task, spec, entry.op, {
+                    dryRun,
+                });
+                if (!result) {
+                    // Re-derive the diagnostic the old inlined version printed.
+                    const roadmap = loadRoadmapForScope(targetDir, scope);
+                    if (!roadmap) {
+                        logv(`  ${entry.op}: no roadmap for scope "${scope}" — no-op`);
+                    }
+                    else {
+                        const milestone = (roadmap.milestones || []).find((m) => m.id === ctx.milestone_id);
+                        if (!milestone) {
+                            logv(`  ${entry.op}: milestone "${ctx.milestone_id}" not found — no-op`);
+                        }
+                        else {
+                            const phase = (milestone.phases || []).find((p) => p.id === ctx.phase_id);
+                            if (!phase) {
+                                logv(`  ${entry.op}: phase "${ctx.phase_id}" not found — no-op`);
+                            }
+                            else if (phase.status !== spec.from) {
+                                logv(`  ${entry.op}: phase "${ctx.phase_id}" status="${phase.status}" (expected "${spec.from}") — no-op`);
+                            }
+                        }
+                    }
+                    return null;
+                }
+                if (result.commit)
+                    commits.push(result.commit);
+                return result.transition;
+            }
+            function applyDecisionRecorded(entry) {
+                const ctx = entry.context || {};
+                const indexPath = join(targetDir, '.aperant', 'decisions', 'INDEX.md');
+                const taskId = ctx.task_id || '-';
+                const source = entry.mode || '-';
+                const summary = (ctx.summary || 'decision recorded').replace(/\|/g, '\\|');
+                const artifactPath = ctx.artifact_path || '-';
+                const date = new Date().toISOString().slice(0, 10);
+                const row = `| ${date} | ${taskId} | ${source} | ${summary} | ${artifactPath} |`;
+                if (dryRun)
+                    return;
+                mkdirSync(dirname(indexPath), { recursive: true });
+                let body;
+                if (existsSync(indexPath)) {
+                    body = readFileSync(indexPath, 'utf-8');
+                    // Idempotent: dedupe by (task_id, artifact_path) pair.
+                    const dedupeKey = `| ${taskId} |`;
+                    const artifactKey = `| ${artifactPath} |`;
+                    const existingLines = body.split('\n');
+                    const hit = existingLines.find((l) => l.includes(dedupeKey) && l.includes(artifactKey));
+                    if (hit) {
+                        logv(`  decision.recorded: already in ledger — no-op`);
+                        return;
+                    }
+                    if (!body.endsWith('\n'))
+                        body += '\n';
+                    body += row + '\n';
+                }
+                else {
+                    body =
+                        '# Decisions Ledger\n\n| Date | Task | Source | Summary | Artifact |\n|---|---|---|---|---|\n';
+                    body += row + '\n';
+                }
+                writeFileSync(indexPath, body, 'utf-8');
+            }
+            // ── Drain loop under the effects-file lock ──────────────────────
+            withFileLock(filePath, () => {
+                const entries = readEffects(filePath);
+                const remaining = [];
+                const deadQueue = [];
+                const budget = limit > 0 ? Math.min(limit, entries.length) : entries.length;
+                for (let i = 0; i < entries.length; i++) {
+                    const entry = entries[i];
+                    if (i >= budget) {
+                        // --limit: leave the rest in the queue for the next pass.
+                        remaining.push(entry);
+                        continue;
+                    }
+                    logv(`processing ${entry.id} op=${entry.op}`);
+                    try {
+                        if (ACK_ONLY_OPS.has(entry.op)) {
+                            drained += 1;
+                            continue;
+                        }
+                        const transSpec = PHASE_TRANSITIONS[entry.op];
+                        if (transSpec) {
+                            const t = applyPhaseTransition(entry, transSpec);
+                            if (t)
+                                transitions.push(t);
+                            drained += 1;
+                            continue;
+                        }
+                        if (entry.op === 'decision.recorded') {
+                            applyDecisionRecorded(entry);
+                            drained += 1;
+                            continue;
+                        }
+                        // Unknown op — ack and move on (forward-compat).
+                        logv(`  unknown op "${entry.op}" — ack-only`);
+                        drained += 1;
+                    }
+                    catch (err) {
+                        failed += 1;
+                        const attempts = (entry.attempts || 0) + 1;
+                        entry.attempts = attempts;
+                        entry.last_error = String(err && err.message ? err.message : err);
+                        if (attempts >= 3) {
+                            parked += 1;
+                            deadQueue.push({
+                                ...entry,
+                                error: entry.last_error,
+                                parked_at: new Date().toISOString(),
+                            });
+                            logv(`  parked after ${attempts} attempts: ${entry.last_error}`);
+                        }
+                        else {
+                            remaining.push(entry);
+                            logv(`  retry queued (attempt ${attempts}/3): ${entry.last_error}`);
+                        }
+                    }
+                }
+                if (dryRun) {
+                    // --dry-run: report but do not persist drained/parked state.
+                    return;
+                }
+                writeEffects(filePath, remaining);
+                if (deadQueue.length > 0) {
+                    const deadPath = join(targetDir, '.aperant', 'pending-effects.dead.jsonl');
+                    mkdirSync(dirname(deadPath), { recursive: true });
+                    const deadBody = (existsSync(deadPath) ? readFileSync(deadPath, 'utf-8') : '') +
+                        deadQueue.map((e) => JSON.stringify(e)).join('\n') +
+                        '\n';
+                    writeFileSync(deadPath, deadBody, 'utf-8');
+                }
+            }, { projectRoot: targetDir });
+            // Compute pending_after post-drain (outside the lock — informational).
+            const pendingAfter = existsSync(filePath) ? readEffects(filePath).length : 0;
+            return ok({
+                status: 'ok',
+                command: 'effects-drain',
+                drained,
+                failed,
+                parked,
+                pending_after: pendingAfter,
+                transitions,
+                commits,
+                dry_run: dryRun || undefined,
+            });
+        }
+        default:
+            return err(`Unknown effects subcommand: ${subcommand}`);
+    }
+}
+//# sourceMappingURL=effects.mjs.map

package/dist/cli/commands/effects.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.mjs","sourceRoot":"","sources":["../../../src/cli/commands/effects.mjs"],"names":[],"mappings":"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"}

package/dist/cli/commands/event.d.mts

@@ -0,0 +1,2 @@
+export function cmdEvent(subcommand: any, projectDir: any, extraArgs: any): import("../util/result.mjs").CommandResult;
+//# sourceMappingURL=event.d.mts.map

package/dist/cli/commands/event.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/event.mjs"],"names":[],"mappings":"AAaA,uHA4OC"}

package/dist/cli/commands/event.mjs

@@ -0,0 +1,235 @@
+/**
+ * commands/event.mjs — append-only event log for coordination history (C29).
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { hostname } from 'node:os';
+import { join, resolve } from 'node:path';
+import { readLifecycleEventsForDay } from '../coordination/event-log.mjs';
+import { createCoordinationStore } from '../coordination/store.mjs';
+import { detectWorktree } from '../git/worktree-detect.mjs';
+import { parseFlags } from '../util/args.mjs';
+import { err, ok } from '../util/result.mjs';
+export function cmdEvent(subcommand, projectDir, extraArgs) {
+    if (!subcommand)
+        return err('Usage: apt-tools event <append|list|rebuild-state> <project-dir> [flags]');
+    if (!projectDir)
+        return err('Usage: apt-tools event ' + subcommand + ' <project-dir> [flags]');
+    const targetDir = resolve(projectDir);
+    // Use shared event dir (coordinates across worktrees via git common dir, same as locks)
+    const wt = detectWorktree(targetDir);
+    const eventsBase = wt.is_worktree && wt.main_repo_root ? wt.main_repo_root : targetDir;
+    const eventsDir = join(eventsBase, '.aperant', 'events');
+    mkdirSync(eventsDir, { recursive: true });
+    const flags = parseFlags(extraArgs);
+    switch (subcommand) {
+        case 'append': {
+            const type = flags.get('type');
+            const subtask = flags.get('subtask') || '';
+            const dataStr = flags.get('data');
+            if (!type)
+                return err('Required: --type <event-type>');
+            // C54 — added install.{started,ok,failed} to signal worktree-install
+            // progress to the statusline chip + external consumers. Data shape:
+            //   install.started — { task_id, ecosystem, pid, started_at, log_path }
+            //   install.ok      — { task_id, ecosystem, duration_ms, log_path }
+            //   install.failed  — { task_id, ecosystem, exit_code, duration_ms, reason, log_path }
+            const validTypes = [
+                'task-claimed',
+                'task-completed',
+                'task-failed',
+                'wave-started',
+                'wave-completed',
+                'install.started',
+                'install.ok',
+                'install.failed',
+            ];
+            if (!validTypes.includes(type)) {
+                return err(`Invalid event type: ${type}. Valid types: ${validTypes.join(', ')}`);
+            }
+            let data = {};
+            if (dataStr) {
+                try {
+                    data = JSON.parse(dataStr);
+                }
+                catch (e) {
+                    return err(`Invalid JSON for --data: ${e.message}`);
+                }
+            }
+            // Find next sequence number — scan existing files for highest number
+            const existingFiles = readdirSync(eventsDir).filter((f) => f.endsWith('.json'));
+            let maxId = 0;
+            for (const f of existingFiles) {
+                const num = parseInt(f.split('-')[0], 10);
+                if (!isNaN(num) && num > maxId)
+                    maxId = num;
+            }
+            const nextId = maxId + 1;
+            const paddedId = String(nextId).padStart(4, '0');
+            const eventFile = `${paddedId}-${type}.json`;
+            const eventPath = join(eventsDir, eventFile);
+            const event = {
+                id: nextId,
+                type,
+                subtask,
+                worker: `${hostname()}-${process.pid}`,
+                timestamp: new Date().toISOString(),
+                data,
+            };
+            // Write with retry on collision (T-11-02 mitigation)
+            let written = false;
+            let attempts = 0;
+            let finalPath = eventPath;
+            let finalFile = eventFile;
+            let writeError = null;
+            while (!written && attempts < 3) {
+                try {
+                    writeFileSync(finalPath, JSON.stringify(event, null, 2) + '\n', { flag: 'wx' });
+                    written = true;
+                }
+                catch (e) {
+                    if (e.code === 'EEXIST') {
+                        attempts++;
+                        const retryId = nextId + attempts;
+                        event.id = retryId;
+                        const retryPadded = String(retryId).padStart(4, '0');
+                        finalFile = `${retryPadded}-${type}.json`;
+                        finalPath = join(eventsDir, finalFile);
+                    }
+                    else {
+                        writeError = `Failed to write event: ${e.message}`;
+                        break;
+                    }
+                }
+            }
+            if (writeError)
+                return err(writeError);
+            if (!written)
+                return err('Failed to write event after 3 collision retries');
+            return ok({ status: 'ok', command: 'event-append', event_file: finalFile, event });
+        }
+        case 'list': {
+            // R10 — `--today` reads the per-day JSONL lifecycle log added in
+            // subtask 4. Separate code path from the legacy numbered-JSON event
+            // list (still used by `event rebuild-state`). `--day YYYY-MM-DD`
+            // reads an arbitrary day bucket.
+            if (flags.has('today') || flags.has('day')) {
+                const day = flags.has('day') ? flags.get('day') : undefined;
+                const events = readLifecycleEventsForDay(targetDir, day);
+                const filtered = flags.has('op')
+                    ? events.filter((e) => e && e.op === flags.get('op'))
+                    : events;
+                return ok({
+                    status: 'ok',
+                    command: 'event-list',
+                    source: 'lifecycle-log',
+                    events: filtered,
+                    count: filtered.length,
+                });
+            }
+            const filterType = flags.get('type');
+            const filterSubtask = flags.get('subtask');
+            const eventFiles = readdirSync(eventsDir)
+                .filter((f) => f.endsWith('.json'))
+                .sort(); // lexicographic = numeric order due to zero-padding
+            const events = [];
+            for (const f of eventFiles) {
+                try {
+                    const event = JSON.parse(readFileSync(join(eventsDir, f), 'utf-8'));
+                    if (filterType && event.type !== filterType)
+                        continue;
+                    if (filterSubtask && event.subtask !== filterSubtask)
+                        continue;
+                    events.push(event);
+                }
+                catch {
+                    // Skip corrupted event files
+                }
+            }
+            return ok({ status: 'ok', command: 'event-list', events, count: events.length });
+        }
+        case 'rebuild-state': {
+            const eventFiles = readdirSync(eventsDir)
+                .filter((f) => f.endsWith('.json'))
+                .sort();
+            const claimed = new Map(); // subtask -> event
+            const completed = new Map(); // subtask -> event
+            const failed = new Map(); // subtask -> event
+            let eventsProcessed = 0;
+            for (const f of eventFiles) {
+                try {
+                    const event = JSON.parse(readFileSync(join(eventsDir, f), 'utf-8'));
+                    // Validate event type before processing (T-11-04 mitigation)
+                    const validTypes = [
+                        'task-claimed',
+                        'task-completed',
+                        'task-failed',
+                        'wave-started',
+                        'wave-completed',
+                        'install.started',
+                        'install.ok',
+                        'install.failed',
+                    ];
+                    if (!validTypes.includes(event.type))
+                        continue;
+                    eventsProcessed++;
+                    switch (event.type) {
+                        case 'task-claimed':
+                            claimed.set(event.subtask, event);
+                            break;
+                        case 'task-completed':
+                            completed.set(event.subtask, event);
+                            claimed.delete(event.subtask); // no longer in-progress
+                            break;
+                        case 'task-failed':
+                            failed.set(event.subtask, event);
+                            claimed.delete(event.subtask); // no longer in-progress
+                            break;
+                        // wave-started and wave-completed are informational
+                    }
+                }
+                catch {
+                    // Skip corrupted files
+                }
+            }
+            // R8 — route state reads/writes through the @internal CoordinationStore
+            // seam so rebuild-state shares a single lock contract with task.mjs
+            // writers. Behavior is byte-for-byte identical to the prior
+            // withFileLock + atomicWriteJson pattern.
+            const store = createCoordinationStore(targetDir);
+            store.updateState((existing) => {
+                let state = {
+                    version: 2,
+                    initialized_at: new Date().toISOString(),
+                    last_activity: new Date().toISOString(),
+                    active_tasks: {},
+                    completed_tasks: [],
+                    decisions: {},
+                    has_tests: false,
+                };
+                if (existing && typeof existing === 'object') {
+                    state = { ...state, ...existing };
+                }
+                state.completed_tasks = Array.from(completed.values()).map((e) => ({
+                    id: e.subtask,
+                    description: e.subtask,
+                    completed_at: e.timestamp,
+                    qa_verdict: 'approved',
+                    commits: Array.isArray(e.data?.commits) ? e.data.commits : [],
+                }));
+                state.last_activity = new Date().toISOString();
+                return state;
+            });
+            return ok({
+                status: 'ok',
+                command: 'event-rebuild-state',
+                events_processed: eventsProcessed,
+                tasks_completed: completed.size,
+                tasks_failed: failed.size,
+                tasks_in_progress: claimed.size,
+            });
+        }
+        default:
+            return err(`Unknown event subcommand: ${subcommand}. Expected: append, list, rebuild-state`);
+    }
+}
+//# sourceMappingURL=event.mjs.map