@miller-tech/uap 2.21.2 → 2.36.1

package/dist/cli/bench-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bench-report.d.ts","sourceRoot":"","sources":["../../src/cli/bench-report.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE;YACL,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,YAAY,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACxE,WAAW,CAAC,EAAE,KAAK,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,WAAW,CAAC,EAAE;gBACZ,KAAK,CAAC,EAAE;oBAAE,SAAS,CAAC,EAAE,MAAM,CAAC;oBAAC,EAAE,CAAC,EAAE;wBAAE,KAAK,CAAC,EAAE,MAAM,CAAC;wBAAC,KAAK,CAAC,EAAE,MAAM,CAAA;qBAAE,CAAC;oBAAC,MAAM,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAC;gBACzF,OAAO,CAAC,EAAE,MAAM,CAAC;gBACjB,OAAO,CAAC,EAAE;oBAAE,CAAC,CAAC,EAAE,MAAM,CAAC;oBAAC,CAAC,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAC;aACtC,CAAC;YACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;gBAAE,SAAS,CAAC,EAAE,MAAM,CAAC;gBAAC,EAAE,CAAC,EAAE;oBAAE,KAAK,CAAC,EAAE,MAAM,CAAC;oBAAC,KAAK,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAC7G,CAAC,CAAC;QACH,cAAc,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACrG,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,SAA2C,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B7H;AAED;;+EAE+E;AAC/E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAqB3D;AAOD,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA2ChE;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CA0CzE;AA+BD,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsExF"}

package/dist/cli/bench-report.js

@@ -0,0 +1,237 @@
+// ---------------------------------------------------------------------------
+// `uap bench report` — the paired-report reader (the delta report
+// as an operator surface). Reports accumulate under benchmark-results/paired-*/;
+// the operator's questions are "what did the latest run measure" and "did the
+// delta HOLD since the last run" — and per the reliability-ladder rule, a delta
+// is never cited without its discrimination status.
+//
+// Split from bench.ts (the paired-run driver) at review: the reader and the
+// driver are separable commands, and the repo pattern is one command per file.
+// ---------------------------------------------------------------------------
+import chalk from 'chalk';
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { basename, join, resolve } from 'path';
+import { termSafe } from '../utils/terminal-safe.js';
+/** One report file read is bounded (P5 polish): these are small harness
+ *  artifacts, and a multi-GB or planted file must not be slurped whole. */
+const MAX_REPORT_BYTES = 4 * 1024 * 1024;
+/**
+ * Paired-run dirs that hold a report.json, newest-first. One bad entry (a
+ * dangling symlink, a vanished dir) must not hide the good reports behind a
+ * misleading "no reports found" — fail-soft per entry, not per directory.
+ */
+export function listPairedReportDirs(root = join(process.cwd(), 'benchmark-results')) {
+    let entries = [];
+    try {
+        entries = readdirSync(root);
+    }
+    catch {
+        return [];
+    }
+    const found = [];
+    for (const e of entries) {
+        const dir = join(root, e);
+        try {
+            if (!statSync(dir).isDirectory())
+                continue;
+        }
+        catch {
+            continue; // dangling symlink / unreadable entry — skip it, keep the rest
+        }
+        const reportPath = join(dir, 'report.json');
+        if (!existsSync(reportPath))
+            continue;
+        try {
+            found.push({ dir, mtimeMs: statSync(reportPath).mtimeMs });
+        }
+        catch {
+            /* unreadable mtime — skip */
+        }
+    }
+    // Newest-first. Ties (e.g. a bulk copy resets mtimes) fall back to the dir
+    // name — paired-run dirs are ISO-timestamped, so lexical order is dated too.
+    return found.sort((a, b) => b.mtimeMs - a.mtimeMs || b.dir.localeCompare(a.dir));
+}
+/** Read one paired-run dir's report.json; null when unreadable.
+ * The harness writes `{ ablation, report: AnalysisReport }` — the reader
+ * unwraps that shape and also accepts a bare report for hand-made fixtures. */
+export function loadReport(dir) {
+    try {
+        const reportPath = join(dir, 'report.json');
+        const st = statSync(reportPath);
+        // Bounded read (P5 polish): these are small harness artifacts — a huge
+        // or planted report.json must not be slurped whole. Oversized is NAMED
+        // and skipped, never a silent drop or a crash.
+        if (st.size > MAX_REPORT_BYTES) {
+            console.warn(`[bench report] ${basename(dir)}/report.json is ${st.size} bytes (over the ${MAX_REPORT_BYTES / (1024 * 1024)} MiB read cap) — skipped`);
+            return null;
+        }
+        const raw = JSON.parse(readFileSync(reportPath, 'utf-8'));
+        const report = raw.report ?? raw;
+        return { dir, mtimeMs: st.mtimeMs, report };
+    }
+    catch {
+        return null;
+    }
+}
+const pp = (x) => Number.isFinite(x) ? `${(x * 100).toFixed(1)}pp` : '—';
+const sign = (x) => !Number.isFinite(x) ? '—' : `${x >= 0 ? '+' : ''}${(x * 100).toFixed(1)}pp`;
+/** Compact delta summary of ONE report — deltas WITH their status, always. */
+export function renderReportSummary(loaded) {
+    const r = loaded.report;
+    const meta = r.meta ?? {};
+    const disc = r.discrimination ?? {};
+    const lines = [];
+    lines.push(chalk.bold(`Paired bench report — ${termSafe(basename(loaded.dir))}`));
+    lines.push(chalk.dim(`  model=${termSafe(String(meta.model ?? '?'))} adapter=${termSafe(String(meta.adapter ?? '?'))} epochs=${meta.epochs ?? '?'} ` +
+        `tasks=${meta.taskCount ?? '?'} started=${termSafe(String(meta.startedAt ?? '?'))}`));
+    lines.push(`  discrimination: ${disc.usable ? chalk.green('usable') : chalk.red('NOT usable')} ` +
+        `(${termSafe(String(disc.status ?? '?'))}${disc.reason ? chalk.dim(` — ${termSafe(String(disc.reason))}`) : ''})`);
+    for (const c of r.comparisons ?? []) {
+        const corr = c.correctness ?? {};
+        const d = corr.delta ?? {};
+        const verdict = corr.verdict ?? '—';
+        const verdictColor = verdict === 'win' ? chalk.green : verdict === 'loss' ? chalk.red : chalk.yellow;
+        lines.push(`  ${chalk.cyan(termSafe(c.label))} vs ${chalk.dim(termSafe(String(c.baseline ?? 'baseline')))}: correctness ` +
+            `${sign(d.meanDelta)} CI [${pp(d.ci?.lower)}, ${pp(d.ci?.upper)}] p=${Number.isFinite(d.pValue) ? d.pValue.toFixed(3) : '—'} ` +
+            `→ ${verdictColor(termSafe(verdict))}${chalk.dim(` (McNemar discordant ${(corr.mcnemar?.b ?? 0) + (corr.mcnemar?.c ?? 0)})`)}`);
+        const metrics = Object.entries(c.metrics ?? {});
+        if (metrics.length > 0) {
+            const parts = metrics
+                .slice(0, 4)
+                .map(([name, m]) => `${termSafe(name)}: ${sign(m.meanDelta)}${m.verdict ? ` (${termSafe(String(m.verdict))})` : ''}`);
+            lines.push(chalk.dim(`    metrics: ${parts.join(' · ')}`));
+        }
+    }
+    lines.push(chalk.dim(disc.usable
+        ? '  (deltas above carry their CI and verdict; see report.md for the full analysis)'
+        : '  (an unusable run is NO MEASUREMENT — fix the suite/adapter before citing any delta)'));
+    return lines.join('\n');
+}
+/** Two-run delta drift: which deltas held, flipped, or narrowed. */
+export function renderComparison(a, b) {
+    // `b` is the NEWER run by caller convention.
+    const lines = [];
+    lines.push(chalk.bold('Paired bench delta drift — two most recent runs'));
+    lines.push(chalk.dim(`  now:    ${termSafe(basename(b.dir))} (${termSafe(String(b.report.meta?.startedAt ?? '?'))})`));
+    lines.push(chalk.dim(`  prev:   ${termSafe(basename(a.dir))} (${termSafe(String(a.report.meta?.startedAt ?? '?'))})`));
+    const discA = a.report.discrimination ?? {};
+    const discB = b.report.discrimination ?? {};
+    lines.push(`  discrimination now/prev: ${discB.usable ? 'usable' : 'NOT usable'}/${discA.usable ? 'usable' : 'NOT usable'} ` +
+        `(${termSafe(String(discB.status ?? '?'))}/${termSafe(String(discA.status ?? '?'))})`);
+    if (!discB.usable || !discA.usable) {
+        lines.push(chalk.yellow('  ⚠ at least one run could not measure — drift between unusable runs is NO MEASUREMENT.'));
+    }
+    const byLabel = (r) => new Map((r.report.comparisons ?? []).map((c) => [c.label, c]));
+    const prev = byLabel(a);
+    const now = byLabel(b);
+    for (const [label, nowC] of now) {
+        const prevC = prev.get(label);
+        if (!prevC) {
+            lines.push(chalk.dim(`  ${termSafe(label)}: no previous comparison to drift against`));
+            continue;
+        }
+        const pd = prevC.correctness?.delta?.meanDelta;
+        const nd = nowC.correctness?.delta?.meanDelta;
+        const pv = prevC.correctness?.verdict ?? '—';
+        const nv = nowC.correctness?.verdict ?? '—';
+        const flipped = pv !== nv;
+        const drift = Number.isFinite(pd) && Number.isFinite(nd)
+            ? `${(nd - pd) * 100 >= 0 ? '+' : ''}${((nd - pd) * 100).toFixed(1)}pp`
+            : '—';
+        lines.push(`  ${chalk.cyan(termSafe(label))}: correctness ${sign(pd)} (${termSafe(pv)}) → ${sign(nd)} (${termSafe(nv)})` +
+            ` drift ${drift}${flipped ? chalk.yellow(` — VERDICT FLIPPED`) : ''}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Print the stored report.md. The harness writes report.json THEN report.md —
+ * an interrupted run can leave the first without the second. That is a
+ * missing-file degradation, never a stack trace: say so, fall back to the
+ * delta summary, exit non-zero. An oversized report.md is the same
+ * degradation (bounded read, P5 polish): named, never slurped.
+ */
+function printFullReport(loaded) {
+    try {
+        const mdPath = join(loaded.dir, 'report.md');
+        const st = statSync(mdPath);
+        if (st.size > MAX_REPORT_BYTES) {
+            console.error(chalk.red(`report.md in ${basename(loaded.dir)}/ is ${st.size} bytes (over the ${MAX_REPORT_BYTES / (1024 * 1024)} MiB read cap) — showing the summary instead.`));
+            console.log(renderReportSummary(loaded));
+            process.exitCode = 1;
+            return;
+        }
+        console.log(readFileSync(mdPath, 'utf-8'));
+    }
+    catch {
+        console.error(chalk.red(`No report.md stored in ${basename(loaded.dir)}/ — the run may have been interrupted; showing the summary instead.`));
+        console.log(renderReportSummary(loaded));
+        process.exitCode = 1;
+    }
+}
+export async function benchReportCommand(options = {}) {
+    const root = options.root ? resolve(options.root) : join(process.cwd(), 'benchmark-results');
+    if (options.dir) {
+        if (options.compare) {
+            console.log(chalk.dim('  (--dir pins a single run; --compare is ignored)'));
+        }
+        const one = loadReport(resolve(options.dir));
+        if (!one) {
+            console.error(chalk.red(`No readable report.json under '${options.dir}'.`));
+            process.exitCode = 1;
+            return;
+        }
+        if (options.json) {
+            console.log(JSON.stringify(one.report, null, 2));
+            return;
+        }
+        if (options.full) {
+            printFullReport(one);
+            return;
+        }
+        console.log(renderReportSummary(one));
+        return;
+    }
+    const dirs = listPairedReportDirs(root);
+    if (dirs.length === 0) {
+        console.error(chalk.red('No paired reports found under benchmark-results/ — run `uap bench paired` first.'));
+        process.exitCode = 1;
+        return;
+    }
+    if (options.compare) {
+        if (dirs.length < 2) {
+            console.error(chalk.red('Only one paired report exists — nothing to compare yet.'));
+            process.exitCode = 1;
+            return;
+        }
+        const [newer, older] = [loadReport(dirs[0].dir), loadReport(dirs[1].dir)];
+        if (!newer || !older) {
+            console.error(chalk.red('The two newest report.json files were not readable.'));
+            process.exitCode = 1;
+            return;
+        }
+        if (options.json) {
+            console.log(JSON.stringify({ now: newer.report, prev: older.report }, null, 2));
+            return;
+        }
+        console.log(renderComparison(older, newer));
+        return;
+    }
+    const latest = loadReport(dirs[0].dir);
+    if (!latest) {
+        console.error(chalk.red(`The newest report (${dirs[0].dir}) was not readable.`));
+        process.exitCode = 1;
+        return;
+    }
+    if (options.json) {
+        console.log(JSON.stringify(latest.report, null, 2));
+        return;
+    }
+    if (options.full) {
+        printFullReport(latest);
+        return;
+    }
+    console.log(renderReportSummary(latest));
+    console.log(chalk.dim(`\n  (${dirs.length} report(s) on disk — \`uap bench report --compare\` for run-to-run drift, --full for the stored markdown)`));
+}
+//# sourceMappingURL=bench-report.js.map

package/dist/cli/bench-report.js.map

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

package/dist/cli/clients.d.ts

@@ -0,0 +1,6 @@
+export interface ClientsOptions {
+    name?: string;
+    port?: string;
+}
+export declare function clientsCommand(action: string, pathArg: string | undefined, options?: ClientsOptions): Promise<void>;
+//# sourceMappingURL=clients.d.ts.map

package/dist/cli/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/cli/clients.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/cli/clients.js

@@ -0,0 +1,142 @@
+/**
+ * `uap clients` — the fleet registry CLI.
+ *
+ * Terminal twin of the dashboard's Clients tab: list discovered client
+ * folders with live summaries, pin/remove manual entries in
+ * `~/.uap/clients.json`, and show what auto-scan finds. The registry feeds
+ * both this command and the `GET /api/clients` route behind the tab.
+ */
+import { resolve } from 'path';
+import { addManualClient, getClientSummaries, listClients, registryFilePath, removeManualClient, scanRootFor, stopClientDashboard, } from '../dashboard/client-registry.js';
+function pad(s, n) {
+    return (s + ' '.repeat(n)).slice(0, Math.max(n, s.length + 1));
+}
+export async function clientsCommand(action, pathArg, options = {}) {
+    const hostCwd = process.cwd();
+    try {
+        await dispatch(action, pathArg, options, hostCwd);
+    }
+    catch (e) {
+        // Registry/stop rejections are operator errors ('client not in registry',
+        // 'not a directory'), not stack traces.
+        console.error(e.message);
+        process.exitCode = 1;
+    }
+}
+async function dispatch(action, pathArg, options, hostCwd) {
+    switch (action) {
+        case 'list':
+            await listCmd(hostCwd);
+            break;
+        case 'add':
+            addCmd(hostCwd, pathArg, options);
+            break;
+        case 'remove':
+            removeCmd(pathArg);
+            break;
+        case 'scan':
+            scanCmd(hostCwd);
+            break;
+        case 'stop':
+            await stopCmd(hostCwd, pathArg);
+            break;
+        default:
+            console.log(`Usage: uap clients <list|add|remove|scan|stop>
+
+  list    Fleet summary for every discovered client (live reads: deliver
+          runs, task queue, git, dashboard health probe)
+  add     Pin a client folder manually: uap clients add <path> [--name n] [--port p]
+  remove  Unpin a manually added client: uap clients remove <path>
+  scan    Show what auto-scan discovers (managed + unmanaged folders)
+  stop    Stop a client's spawned dashboard: uap clients stop <path>
+
+Registry: ${registryFilePath()}`);
+            break;
+    }
+}
+async function listCmd(hostCwd) {
+    console.log(`Scan root: ${scanRootFor(hostCwd)}`);
+    console.log(`Registry:  ${registryFilePath()}`);
+    const clients = await getClientSummaries(hostCwd, 0);
+    if (!clients.length) {
+        console.log('No client folders discovered.');
+        return;
+    }
+    console.log('');
+    console.log(pad('CLIENT', 22) + pad('STATE', 16) + pad('BRANCH', 14) + pad('QUEUE', 24) + pad('DELIVER', 24) + 'DASH');
+    for (const c of clients) {
+        const state = c.host ? 'this host' : c.managed ? (c.dashboardAlive ? 'up' : 'down') : 'unmanaged';
+        const queue = `${c.tasks.inProgress} ip · ${c.tasks.open} open · ${c.tasks.blocked} blocked`;
+        const deliver = `${c.deliver.running} run · ${c.deliver.interrupted} int · ${c.deliver.failed} fail`;
+        // The CLI doesn't know which port the host dashboard is live on (only the
+        // server does), so the host row never claims a probe result.
+        const dash = c.host ? 'this' : c.dashboardAlive ? `:${c.port}` : '-';
+        console.log(pad(c.name, 22) + pad(state, 16) + pad(c.branch === '?' ? '-' : c.branch, 14) + pad(queue, 24) + pad(deliver, 24) +
+            dash + (c.degraded ? '  (degraded)' : ''));
+    }
+    console.log('');
+    console.log(`Open a client's dashboard from the web UI Clients tab, or: uap dashboard serve (inside the client).`);
+}
+function addCmd(hostCwd, pathArg, options) {
+    if (!pathArg) {
+        console.error('Usage: uap clients add <path> [--name <name>] [--port <port>]');
+        process.exitCode = 1;
+        return;
+    }
+    const port = options.port ? Number(options.port) : undefined;
+    if (port !== undefined && (!Number.isInteger(port) || port < 1024 || port > 65535)) {
+        console.error('--port must be an integer in 1024..65535');
+        process.exitCode = 1;
+        return;
+    }
+    const entry = addManualClient(hostCwd, resolve(pathArg), { name: options.name, port });
+    console.log(`Pinned client "${entry.name}" (${entry.path})${entry.port ? ` — dashboard port ${entry.port}` : ''}`);
+}
+function removeCmd(pathArg) {
+    if (!pathArg) {
+        console.error('Usage: uap clients remove <path>');
+        process.exitCode = 1;
+        return;
+    }
+    if (removeManualClient(resolve(pathArg))) {
+        console.log(`Unpinned ${resolve(pathArg)}`);
+    }
+    else {
+        console.log(`No manual entry for ${resolve(pathArg)} (auto-scanned folders need no removal — they drop out when the folder moves or a pattern ignores them).`);
+    }
+}
+function scanCmd(hostCwd) {
+    const entries = listClients(hostCwd);
+    const root = scanRootFor(hostCwd);
+    console.log(`Scanning ${root}`);
+    if (!entries.length) {
+        console.log('Nothing found.');
+        return;
+    }
+    for (const c of entries) {
+        const tags = [c.host ? 'this host' : '', c.managed ? 'managed' : 'unmanaged', c.manual ? 'pinned' : 'scanned']
+            .filter(Boolean)
+            .join(', ');
+        console.log(`  ${pad(c.name, 26)} ${tags}${c.port ? `  (port ${c.port})` : ''}`);
+    }
+    console.log(`\n${entries.filter((c) => c.manual).length} pinned, ${entries.filter((c) => !c.manual).length} scanned.`);
+}
+async function stopCmd(hostCwd, pathArg) {
+    if (!pathArg) {
+        console.error('Usage: uap clients stop <path>');
+        process.exitCode = 1;
+        return;
+    }
+    const res = await stopClientDashboard(hostCwd, resolve(pathArg));
+    if (res.stopped) {
+        console.log(`Stopped client dashboard on :${res.port}`);
+    }
+    else if (!res.wasAlive) {
+        console.log('No live dashboard for that client.');
+    }
+    else {
+        console.error(`Could not stop: ${res.reason}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=clients.js.map

package/dist/cli/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../src/cli/clients.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AAOzC,SAAS,GAAG,CAAC,CAAS,EAAE,CAAS;IAC/B,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,OAA2B,EAC3B,UAA0B,EAAE;IAE5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,0EAA0E;QAC1E,wCAAwC;QACxC,OAAO,CAAC,KAAK,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,MAAc,EACd,OAA2B,EAC3B,OAAuB,EACvB,OAAe;IAEf,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YACvB,MAAM;QACR,KAAK,KAAK;YACR,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAClC,MAAM;QACR,KAAK,QAAQ;YACX,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,MAAM;QACR,KAAK,MAAM;YACT,OAAO,CAAC,OAAO,CAAC,CAAC;YACjB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAChC,MAAM;QACR;YACE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;YASN,gBAAgB,EAAE,EAAE,CAAC,CAAC;YAC5B,MAAM;IACV,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,OAAe;IACpC,OAAO,CAAC,GAAG,CAAC,cAAc,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,cAAc,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACrD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,MAAM,CAC1G,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAClG,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC;QAC7F,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,UAAU,CAAC,CAAC,OAAO,CAAC,WAAW,UAAU,CAAC,CAAC,OAAO,CAAC,MAAM,OAAO,CAAC;QACrG,0EAA0E;QAC1E,6DAA6D;QAC7D,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACrE,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/G,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAC5C,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,qGAAqG,CAAC,CAAC;AACrH,CAAC;AAED,SAAS,MAAM,CAAC,OAAe,EAAE,OAA2B,EAAE,OAAuB;IACnF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAC/E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QACnF,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvF,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrH,CAAC;AAED,SAAS,SAAS,CAAC,OAA2B;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,IAAI,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,CAAC,OAAO,CAAC,0GAA0G,CAAC,CAAC;IACjK,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,OAAe;IAC9B,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;aAC3G,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,YAAY,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC;AACzH,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,OAA2B;IACjE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,gCAAgC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;SAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/dashboard-grants.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The dashboard's Sandbox Grants section (the ADR 0011-named operator
+ * surface: active authority per session, the trust-anchor verdict, and the
+ * revoke command per grant).
+ *
+ * Split from src/cli/dashboard.ts: the dashboard module is the repo's worst
+ * LOC offender, and new sections follow the export-for-test pattern — a
+ * separate module keeps the render file
+ * from growing with every surface and gives the tests a direct import.
+ */
+/** Humanize the remaining TTL of a grant (ISO expiry) for one glance. */
+export declare function humanRemaining(expiresAt: string): string;
+/**
+ * The Sandbox Grants section as plain lines — active authority per session,
+ * the trust-anchor verdict, and the revoke command per grant. The ADR
+ * 0011-named surface ("a dashboard grants view... one click to revoke" — the
+ * CLI's one click is the printed command). Pure w.r.t. projectRoot + the
+ * env pins, so tests seed a ledger and call directly.
+ * A line starting with ⚠ (after leading indent) is a warning the caller
+ * colors red.
+ */
+export declare function sandboxGrantsLines(projectRoot: string, maxGrants?: number): {
+    lines: string[];
+    mismatch: boolean;
+};
+//# sourceMappingURL=dashboard-grants.d.ts.map

package/dist/cli/dashboard-grants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-grants.d.ts","sourceRoot":"","sources":["../../src/cli/dashboard-grants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CASxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CA4B7G"}

package/dist/cli/dashboard-grants.js

@@ -0,0 +1,69 @@
+/**
+ * The dashboard's Sandbox Grants section (the ADR 0011-named operator
+ * surface: active authority per session, the trust-anchor verdict, and the
+ * revoke command per grant).
+ *
+ * Split from src/cli/dashboard.ts: the dashboard module is the repo's worst
+ * LOC offender, and new sections follow the export-for-test pattern — a
+ * separate module keeps the render file
+ * from growing with every surface and gives the tests a direct import.
+ */
+import { listAuthority, verifyLedgerIntegrity } from '../policies/sandbox-grants.js';
+/** Humanize the remaining TTL of a grant (ISO expiry) for one glance. */
+export function humanRemaining(expiresAt) {
+    const ms = Date.parse(expiresAt) - Date.now();
+    if (!Number.isFinite(ms))
+        return 'unknown';
+    if (ms <= 0)
+        return 'expired';
+    const mins = Math.floor(ms / 60_000);
+    if (mins < 60)
+        return `~${Math.max(1, mins)}m left`;
+    const hours = Math.floor(mins / 60);
+    if (hours < 48)
+        return `~${hours}h ${mins % 60}m left`;
+    return `~${Math.floor(hours / 24)}d left`;
+}
+/**
+ * The Sandbox Grants section as plain lines — active authority per session,
+ * the trust-anchor verdict, and the revoke command per grant. The ADR
+ * 0011-named surface ("a dashboard grants view... one click to revoke" — the
+ * CLI's one click is the printed command). Pure w.r.t. projectRoot + the
+ * env pins, so tests seed a ledger and call directly.
+ * A line starting with ⚠ (after leading indent) is a warning the caller
+ * colors red.
+ */
+export function sandboxGrantsLines(projectRoot, maxGrants = 6) {
+    const lines = [];
+    const integrity = verifyLedgerIntegrity(projectRoot);
+    const active = listAuthority(projectRoot);
+    lines.push('Sandbox Grants (active authority)');
+    if (active.length === 0) {
+        lines.push('  no active grants — the default is least authority');
+    }
+    else {
+        for (const g of active.slice(0, maxGrants)) {
+            lines.push(`  ${g.id}  session '${g.sessionId}'  ${humanRemaining(g.expiresAt)}  (granted by ${g.grantedBy})`);
+            lines.push(`    reason: ${g.reason}`);
+            for (const p of g.paths.slice(0, 3))
+                lines.push(`      ${p}`);
+            if (g.paths.length > 3)
+                lines.push(`      … and ${g.paths.length - 3} more path(s)`);
+            lines.push(`    revoke: uap sandbox revoke ${g.id}`);
+        }
+        if (active.length > maxGrants)
+            lines.push(`  … and ${active.length - maxGrants} more grant(s)`);
+    }
+    if (integrity.state === 'ok') {
+        lines.push('  ledger verified against its trust anchor');
+    }
+    else if (integrity.state === 'unanchored') {
+        lines.push(`  ${integrity.detail}`);
+    }
+    else {
+        lines.push(`  ⚠ INTEGRITY MISMATCH — ${integrity.detail}.`);
+        lines.push('  ⚠ Rows above are listed but UNVERIFIED; a sandbox session opens ZERO grant-derived holes.');
+    }
+    return { lines, mismatch: integrity.state === 'mismatch' };
+}
+//# sourceMappingURL=dashboard-grants.js.map

package/dist/cli/dashboard-grants.js.map

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

package/dist/cli/dashboard-pace.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The dashboard's Measured Pace rows — the compute/render
+ * split. Extracted from src/cli/dashboard.ts so the shaping contract (the
+ * estimate gate, most-attempts-first ranking, the honest thin/beyond-cap
+ * counts) is testable WITHOUT the cwd-pinned `getModelAnalytics()` singleton:
+ * tests construct their own ModelAnalytics at a tmp path and pass it in.
+ */
+import { ModelAnalytics } from '../models/analytics.js';
+/** One row of the dashboard's Measured Pace table (plain display strings —
+ *  the caller pads and colors). */
+export interface PaceRow {
+    modelId: string;
+    key: string;
+    perTask: string;
+    spread: string;
+    n: string;
+    successPct: string;
+}
+/**
+ * Compute the Measured Pace rows + honest caveats: the agent's own EWMA
+ * estimate per (model, taskType, complexity) key — the operator's legibility
+ * surface for "how long does this model actually take here". Only keys with
+ * a real estimate get a row; the honest caveats (thin keys, keys beyond the
+ * cap) travel as counts. Pure with respect to the instance.
+ */
+export declare function computeMeasuredPace(analytics: ModelAnalytics, cap?: number): Promise<{
+    rows: PaceRow[];
+    thin: number;
+    more: number;
+}>;
+//# sourceMappingURL=dashboard-pace.d.ts.map

package/dist/cli/dashboard-pace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-pace.d.ts","sourceRoot":"","sources":["../../src/cli/dashboard-pace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD;mCACmC;AACnC,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,cAAc,EACzB,GAAG,SAAI,GACN,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAuB1D"}

package/dist/cli/dashboard-pace.js

@@ -0,0 +1,42 @@
+/**
+ * The dashboard's Measured Pace rows — the compute/render
+ * split. Extracted from src/cli/dashboard.ts so the shaping contract (the
+ * estimate gate, most-attempts-first ranking, the honest thin/beyond-cap
+ * counts) is testable WITHOUT the cwd-pinned `getModelAnalytics()` singleton:
+ * tests construct their own ModelAnalytics at a tmp path and pass it in.
+ */
+import { ewmaEstimate, formatDurationMs } from '../delivery/eta-estimate.js';
+import { termSafe } from '../utils/terminal-safe.js';
+/**
+ * Compute the Measured Pace rows + honest caveats: the agent's own EWMA
+ * estimate per (model, taskType, complexity) key — the operator's legibility
+ * surface for "how long does this model actually take here". Only keys with
+ * a real estimate get a row; the honest caveats (thin keys, keys beyond the
+ * cap) travel as counts. Pure with respect to the instance.
+ */
+export async function computeMeasuredPace(analytics, cap = 8) {
+    const allPaceKeys = analytics.distinctOutcomeKeys();
+    const paceKeys = allPaceKeys.slice(0, cap);
+    const rows = [];
+    for (const k of paceKeys) {
+        const est = ewmaEstimate(analytics.recentDurations(k.modelId, k.taskType, k.complexity));
+        if (!est)
+            continue;
+        // Foreign strings (the id especially can arrive from env/config) are
+        // termSafe'd at the compute choke point; the caller only pads/colors.
+        rows.push({
+            modelId: termSafe(k.modelId),
+            key: termSafe(`${k.taskType}/${k.complexity}`),
+            perTask: `~${formatDurationMs(est.etaMs)}`,
+            spread: `${formatDurationMs(est.minMs)}–${formatDurationMs(est.maxMs)}`,
+            n: `${est.samples}/${est.observed}`,
+            successPct: (100 * est.successRate).toFixed(0) + '%',
+        });
+    }
+    return {
+        rows,
+        thin: paceKeys.length - rows.length,
+        more: Math.max(0, allPaceKeys.length - cap),
+    };
+}
+//# sourceMappingURL=dashboard-pace.js.map

package/dist/cli/dashboard-pace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-pace.js","sourceRoot":"","sources":["../../src/cli/dashboard-pace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE7E,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAarD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAAyB,EACzB,GAAG,GAAG,CAAC;IAEP,MAAM,WAAW,GAAG,SAAS,CAAC,mBAAmB,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,qEAAqE;QACrE,sEAAsE;QACtE,IAAI,CAAC,IAAI,CAAC;YACR,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5B,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YAC9C,OAAO,EAAE,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YAC1C,MAAM,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACvE,CAAC,EAAE,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE;YACnC,UAAU,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG;SACrD,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;QACnC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,GAAG,CAAC;KAC5C,CAAC;AACJ,CAAC"}