@goxtechnologies/connectwise-psa-mcp 1.1.0

package/dist/operations/analytics-extended.js

@@ -0,0 +1,825 @@
+// ConnectWise PSA MCP Server — Extended Analytics Handlers (52 handlers)
+// Split from analytics.ts for manageability. Imported and registered at load time.
+import { getAPI } from '../services/connectwise-api.js';
+function num(v, fallback = 0) { const n = Number(v); return Number.isFinite(n) ? n : fallback; }
+function nested(obj, field, sub) { const c = obj[field]; if (c && typeof c === 'object' && sub in c)
+    return String(c[sub] ?? 'N/A'); return 'N/A'; }
+function daysSince(iso) { if (!iso)
+    return 0; return Math.floor((Date.now() - new Date(iso).getTime()) / 86400000); }
+function daysAgo(n) { const d = new Date(); d.setDate(d.getDate() - n); return d.toISOString().split('T')[0] + 'T00:00:00Z'; }
+function today() { return new Date().toISOString().split('T')[0] + 'T00:00:00Z'; }
+function round2(n) { return Math.round(n * 100) / 100; }
+/** All extended handlers keyed by name. Merged into the main registry by analytics.ts. */
+export const extendedHandlers = {};
+function reg(name, handler) { extendedHandlers[name] = handler; }
+// ===========================================================================
+// ADVANCED ANALYTICS
+// ===========================================================================
+reg('member_utilization_report', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 30);
+    const [members, timeEntries] = await Promise.all([
+        api.paginatedFetch('/system/members', 'inactiveFlag=false', 'id,identifier,firstName,lastName', 200),
+        api.paginatedFetch('/time/entries', `dateEntered>=[${daysAgo(days)}]`, 'id,actualHours,billableOption,member/identifier', 5000),
+    ]);
+    const md = {};
+    for (const m of members.items)
+        md[String(m.identifier)] = { total: 0, billable: 0, name: `${m.firstName} ${m.lastName}` };
+    for (const e of timeEntries.items) {
+        const id = nested(e, 'member', 'identifier');
+        if (!md[id])
+            md[id] = { total: 0, billable: 0, name: id };
+        md[id].total += num(e.actualHours);
+        if (String(e.billableOption ?? '').toLowerCase().includes('billable'))
+            md[id].billable += num(e.actualHours);
+    }
+    const wh = days * 8 * 5 / 7;
+    const lines = [`## Member Utilization Report (last ${days} days)\n`, '| Member | Total | Billable | Utilization | Billable % |', '|--------|-------|----------|-------------|------------|'];
+    for (const [id, d] of Object.entries(md).filter(([, d]) => d.total > 0).sort((a, b) => b[1].total - a[1].total))
+        lines.push(`| ${d.name} (${id}) | ${round2(d.total)}h | ${round2(d.billable)}h | ${round2((d.total / wh) * 100)}% | ${d.total > 0 ? round2((d.billable / d.total) * 100) : 0}% |`);
+    return lines.join('\n');
+});
+reg('timesheet_summary', async () => {
+    const api = getAPI();
+    const entries = await api.paginatedFetch('/time/entries', `dateEntered>=[${daysAgo(14)}]`, 'id,actualHours,member/identifier,dateEntered,billableOption', 5000);
+    const bm = {};
+    for (const e of entries.items) {
+        const m = nested(e, 'member', 'identifier');
+        if (!bm[m])
+            bm[m] = { total: 0, billable: 0, days: new Set() };
+        bm[m].total += num(e.actualHours);
+        if (String(e.billableOption ?? '').toLowerCase().includes('billable'))
+            bm[m].billable += num(e.actualHours);
+        bm[m].days.add(String(e.dateEntered ?? '').substring(0, 10));
+    }
+    const lines = ['## Timesheet Summary (last 14 days)\n', '| Member | Total | Billable | Days | Avg/Day |', '|--------|-------|----------|------|---------|'];
+    for (const [m, d] of Object.entries(bm).sort((a, b) => b[1].total - a[1].total))
+        lines.push(`| ${m} | ${round2(d.total)}h | ${round2(d.billable)}h | ${d.days.size} | ${d.days.size > 0 ? round2(d.total / d.days.size) : 0}h |`);
+    return lines.join('\n');
+});
+reg('unbilled_time_report', async () => {
+    const api = getAPI();
+    const r = await api.paginatedFetch('/time/entries', "billableOption='Billable' AND invoiceFlag=false", 'id,actualHours,company/name,member/identifier', 2000);
+    if (r.items.length === 0)
+        return 'No unbilled time entries found.';
+    const bc = {};
+    for (const e of r.items) {
+        const co = nested(e, 'company', 'name');
+        if (!bc[co])
+            bc[co] = { hours: 0, entries: 0 };
+        bc[co].hours += num(e.actualHours);
+        bc[co].entries++;
+    }
+    const tot = r.items.reduce((s, e) => s + num(e.actualHours), 0);
+    const lines = [`## Unbilled Time Report (${r.items.length} entries, ${round2(tot)}h)\n`, '| Company | Hours | Entries |', '|---------|-------|---------|'];
+    for (const [co, d] of Object.entries(bc).sort((a, b) => b[1].hours - a[1].hours))
+        lines.push(`| ${co} | ${round2(d.hours)}h | ${d.entries} |`);
+    return lines.join('\n');
+});
+reg('agreement_utilization_tracker', async () => {
+    const api = getAPI();
+    const agr = await api.paginatedFetch('/finance/agreements', 'cancelledFlag=false', 'id,name,company/name,type/name,budgetHours', 200);
+    const batch = agr.items.slice(0, 30);
+    const res = await Promise.allSettled(batch.map(async (a) => { const t = await api.paginatedFetch('/time/entries', `agreement/id=${a.id}`, 'id,actualHours', 500); return { a, hours: t.items.reduce((s, e) => s + num(e.actualHours), 0) }; }));
+    const lines = ['## Agreement Utilization Tracker\n', '| Agreement | Company | Budget | Used | % | Status |', '|-----------|---------|--------|------|---|--------|'];
+    for (const r of res) {
+        if (r.status !== 'fulfilled')
+            continue;
+        const { a, hours } = r.value;
+        const b = num(a.budgetHours);
+        const p = b > 0 ? round2((hours / b) * 100) : 0;
+        const st = b === 0 ? 'N/A' : p > 100 ? 'OVER' : p > 80 ? 'At risk' : 'OK';
+        lines.push(`| ${a.name} | ${nested(a, 'company', 'name')} | ${b}h | ${round2(hours)}h | ${p}% | ${st} |`);
+    }
+    return lines.join('\n');
+});
+reg('repeat_caller_analysis', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 90);
+    const r = await api.paginatedFetch('/service/tickets', `dateEntered>=[${daysAgo(days)}]`, 'id,contact/name,contact/id,company/name', 2000);
+    const bc = {};
+    for (const t of r.items) {
+        const cid = String(nested(t, 'contact', 'id'));
+        if (cid === 'N/A')
+            continue;
+        if (!bc[cid])
+            bc[cid] = { name: nested(t, 'contact', 'name'), company: nested(t, 'company', 'name'), count: 0 };
+        bc[cid].count++;
+    }
+    const rp = Object.values(bc).filter(c => c.count >= 3).sort((a, b) => b.count - a.count);
+    if (rp.length === 0)
+        return `No repeat callers (3+) in the last ${days} days.`;
+    const lines = [`## Repeat Caller Analysis (last ${days} days)\n`, '| Contact | Company | Tickets |', '|---------|---------|---------|'];
+    for (const c of rp.slice(0, 30))
+        lines.push(`| ${c.name} | ${c.company} | ${c.count} |`);
+    return lines.join('\n');
+});
+reg('ticket_category_trends', async () => {
+    const api = getAPI();
+    const r = await api.paginatedFetch('/service/tickets', `dateEntered>=[${daysAgo(30)}]`, 'id,type/name,subType/name', 2000);
+    const bt = {};
+    for (const t of r.items) {
+        const k = nested(t, 'subType', 'name') !== 'N/A' ? `${nested(t, 'type', 'name')} > ${nested(t, 'subType', 'name')}` : nested(t, 'type', 'name');
+        bt[k] = (bt[k] ?? 0) + 1;
+    }
+    const lines = [`## Ticket Category Trends (30 days, ${r.items.length} tickets)\n`, '| Category | Count | % |', '|----------|-------|---|'];
+    for (const [k, v] of Object.entries(bt).sort((a, b) => b[1] - a[1]).slice(0, 25))
+        lines.push(`| ${k} | ${v} | ${round2((v / r.items.length) * 100)}% |`);
+    return lines.join('\n');
+});
+reg('time_entry_anomaly_detection', async () => {
+    const api = getAPI();
+    const entries = await api.paginatedFetch('/time/entries', `dateEntered>=[${daysAgo(30)}]`, 'id,actualHours,member/identifier,dateEntered,notes', 5000);
+    const anomalies = [];
+    for (const e of entries.items) {
+        const h = num(e.actualHours);
+        if (h > 12)
+            anomalies.push({ type: 'Excessive', detail: `${h}h`, e });
+        const dow = new Date(String(e.dateEntered ?? '').substring(0, 10)).getDay();
+        if ((dow === 0 || dow === 6) && h > 0)
+            anomalies.push({ type: 'Weekend', detail: `${h}h`, e });
+    }
+    if (anomalies.length === 0)
+        return 'No anomalies detected.';
+    const lines = [`## Time Entry Anomalies (${anomalies.length} found)\n`, '| Type | Member | Hours | Date |', '|------|--------|-------|------|'];
+    for (const a of anomalies.slice(0, 50))
+        lines.push(`| ${a.type} | ${nested(a.e, 'member', 'identifier')} | ${a.e.actualHours}h | ${String(a.e.dateEntered ?? '').substring(0, 10)} |`);
+    return lines.join('\n');
+});
+reg('billing_leakage_detection', async () => {
+    const api = getAPI();
+    const [unbilled, noAgr] = await Promise.all([
+        api.paginatedFetch('/time/entries', "billableOption='Billable' AND invoiceFlag=false", 'id,actualHours', 1000),
+        api.paginatedFetch('/time/entries', `billableOption='Billable' AND agreement=null AND dateEntered>=[${daysAgo(30)}]`, 'id,actualHours', 500),
+    ]);
+    return ['## Billing Leakage Detection\n', '| Leak Type | Entries | Hours |', '|-----------|---------|-------|', `| Unbilled billable | ${unbilled.items.length} | ${round2(unbilled.items.reduce((s, e) => s + num(e.actualHours), 0))}h |`, `| Billable no agreement (30d) | ${noAgr.items.length} | ${round2(noAgr.items.reduce((s, e) => s + num(e.actualHours), 0))}h |`].join('\n');
+});
+reg('project_burn_rate', async (params) => {
+    const api = getAPI();
+    const pid = num(params['project_id']);
+    if (!pid)
+        return 'Error: project_id required.';
+    const [proj, time] = await Promise.all([api.request({ path: `/project/projects/${pid}`, method: 'GET' }), api.paginatedFetch('/time/entries', `chargeToType='Project' AND chargeToId=${pid}`, 'id,actualHours', 2000)]);
+    const b = num(proj.data.budgetHours);
+    const t = time.items.reduce((s, e) => s + num(e.actualHours), 0);
+    return [`## Project Burn Rate: ${proj.data.name} (#${pid})\n`, '| Metric | Value |', '|--------|-------|', `| Budget | ${b}h |`, `| Consumed | ${round2(t)}h (${b > 0 ? round2((t / b) * 100) : 0}%) |`, `| Remaining | ${round2(b - t)}h |`].join('\n');
+});
+reg('agreement_renewal_forecast', async () => {
+    const api = getAPI();
+    const r = await api.paginatedFetch('/finance/agreements', `cancelledFlag=false AND endDate>=[${today()}]`, 'id,name,company/name,endDate,billAmount', 200);
+    const expiring = r.items.filter(a => a.endDate && -daysSince(a.endDate) <= 90);
+    if (expiring.length === 0)
+        return 'No agreements expiring in the next 90 days.';
+    const lines = [`## Agreement Renewal Forecast (${expiring.length} in next 90 days)\n`, '| Agreement | Company | Expires | MRR |', '|-----------|---------|---------|-----|'];
+    for (const a of expiring.sort((x, y) => String(x.endDate ?? '').localeCompare(String(y.endDate ?? ''))))
+        lines.push(`| ${a.name} | ${nested(a, 'company', 'name')} | ${String(a.endDate ?? '').substring(0, 10)} | $${num(a.billAmount)} |`);
+    return lines.join('\n');
+});
+reg('resource_capacity_planning', async () => {
+    const api = getAPI();
+    const [members, time, sched] = await Promise.all([api.paginatedFetch('/system/members', 'inactiveFlag=false', 'id,identifier,firstName,lastName', 200), api.paginatedFetch('/time/entries', `dateEntered>=[${daysAgo(14)}]`, 'id,actualHours,member/identifier', 5000), api.paginatedFetch('/schedule/entries', `dateStart>=[${daysAgo(14)}]`, 'id,hours,member/identifier', 2000)]);
+    const d = {};
+    for (const m of members.items)
+        d[String(m.identifier)] = { name: `${m.firstName} ${m.lastName}`, logged: 0, sched: 0 };
+    for (const e of time.items) {
+        const id = nested(e, 'member', 'identifier');
+        if (d[id])
+            d[id].logged += num(e.actualHours);
+    }
+    for (const e of sched.items) {
+        const id = nested(e, 'member', 'identifier');
+        if (d[id])
+            d[id].sched += num(e.hours);
+    }
+    const cap = 80;
+    const lines = ['## Resource Capacity (14 days)\n', '| Member | Logged | Scheduled | Available |', '|--------|--------|-----------|-----------|'];
+    for (const [id, v] of Object.entries(d).filter(([, v]) => v.logged > 0).sort((a, b) => b[1].logged - a[1].logged))
+        lines.push(`| ${v.name} (${id}) | ${round2(v.logged)}h | ${round2(v.sched)}h | ${round2(cap - v.logged)}h |`);
+    return lines.join('\n');
+});
+reg('mean_time_metrics', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 30);
+    const r = await api.paginatedFetch('/service/tickets', `closedFlag=true AND closedDate>=[${daysAgo(days)}]`, 'id,board/name,dateEntered,closedDate', 2000);
+    const bb = {};
+    for (const t of r.items) {
+        const b = nested(t, 'board', 'name');
+        (bb[b] ??= []).push((new Date(t.closedDate).getTime() - new Date(t.dateEntered).getTime()) / 3600000);
+    }
+    const avg = (a) => a.length > 0 ? round2(a.reduce((x, y) => x + y, 0) / a.length) : 0;
+    const lines = [`## Mean Time Metrics (last ${days} days)\n`, '| Board | MTTR (hours) | Tickets |', '|-------|-------------|---------|'];
+    for (const [b, times] of Object.entries(bb).sort((a, b) => b[1].length - a[1].length))
+        lines.push(`| ${b} | ${avg(times)}h | ${times.length} |`);
+    return lines.join('\n');
+});
+reg('top_time_consumers', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 30);
+    const e = await api.paginatedFetch('/time/entries', `dateEntered>=[${daysAgo(days)}]`, 'id,actualHours,company/name,chargeToId,chargeToType', 5000);
+    const bc = {};
+    const bt = {};
+    for (const x of e.items) {
+        bc[nested(x, 'company', 'name')] = (bc[nested(x, 'company', 'name')] ?? 0) + num(x.actualHours);
+        if (x.chargeToType === 'ServiceTicket')
+            bt[String(x.chargeToId)] = (bt[String(x.chargeToId)] ?? 0) + num(x.actualHours);
+    }
+    const lines = [`## Top Time Consumers (${days} days)\n`, '### By Company', '| Company | Hours |', '|---------|-------|'];
+    for (const [k, v] of Object.entries(bc).sort((a, b) => b[1] - a[1]).slice(0, 15))
+        lines.push(`| ${k} | ${round2(v)}h |`);
+    lines.push('\n### By Ticket', '| Ticket | Hours |', '|--------|-------|');
+    for (const [k, v] of Object.entries(bt).sort((a, b) => b[1] - a[1]).slice(0, 15))
+        lines.push(`| #${k} | ${round2(v)}h |`);
+    return lines.join('\n');
+});
+reg('agreement_coverage_gaps', async () => {
+    const api = getAPI();
+    const [cos, agrs] = await Promise.all([api.paginatedFetch('/company/companies', "status/name='Active'", 'id,name', 500), api.paginatedFetch('/finance/agreements', 'cancelledFlag=false', 'id,company/id', 500)]);
+    const covered = new Set(agrs.items.map(a => String(nested(a, 'company', 'id'))));
+    const uncovered = cos.items.filter(c => !covered.has(String(c.id)));
+    const lines = [`## Agreement Coverage Gaps\n`, `**Uncovered:** ${uncovered.length} of ${cos.items.length} active companies\n`];
+    if (uncovered.length > 0) {
+        lines.push('| Company |', '|---------|');
+        for (const c of uncovered.slice(0, 30))
+            lines.push(`| ${c.name} |`);
+    }
+    return lines.join('\n');
+});
+reg('weekend_work_report', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 30);
+    const e = await api.paginatedFetch('/time/entries', `dateEntered>=[${daysAgo(days)}]`, 'id,actualHours,member/identifier,dateEntered', 5000);
+    const wk = e.items.filter(x => { const d = new Date(String(x.dateEntered ?? '').substring(0, 10)).getDay(); return d === 0 || d === 6; });
+    if (wk.length === 0)
+        return `No weekend work in the last ${days} days.`;
+    const bm = {};
+    for (const x of wk) {
+        const m = nested(x, 'member', 'identifier');
+        bm[m] = (bm[m] ?? 0) + num(x.actualHours);
+    }
+    const lines = [`## Weekend Work (${days} days, ${wk.length} entries, ${round2(wk.reduce((s, x) => s + num(x.actualHours), 0))}h)\n`, '| Member | Hours |', '|--------|-------|'];
+    for (const [m, h] of Object.entries(bm).sort((a, b) => b[1] - a[1]))
+        lines.push(`| ${m} | ${round2(h)}h |`);
+    return lines.join('\n');
+});
+reg('sla_compliance_dashboard', async () => {
+    const api = getAPI();
+    const r = await api.paginatedFetch('/service/tickets', `closedFlag=true AND closedDate>=[${daysAgo(30)}]`, 'id,board/name,dateEntered,closedDate', 2000);
+    const bb = {};
+    for (const t of r.items) {
+        const b = nested(t, 'board', 'name');
+        if (!bb[b])
+            bb[b] = { total: 0, ok: 0 };
+        bb[b].total++;
+        if ((new Date(t.closedDate).getTime() - new Date(t.dateEntered).getTime()) / 3600000 < 72)
+            bb[b].ok++;
+    }
+    const lines = ['## SLA Compliance (30 days)\n', '| Board | Total | Within SLA | % |', '|-------|-------|-----------|---|'];
+    for (const [b, d] of Object.entries(bb).sort((a, b) => b[1].total - a[1].total))
+        lines.push(`| ${b} | ${d.total} | ${d.ok} | ${d.total > 0 ? round2((d.ok / d.total) * 100) : 0}% |`);
+    return lines.join('\n');
+});
+reg('sla_breach_alerts', async () => {
+    const api = getAPI();
+    const r = await api.paginatedFetch('/service/tickets', 'closedFlag=false', 'id,summary,priority/name,company/name,dateEntered', 1000);
+    const atRisk = r.items.filter(t => { const age = daysSince(t.dateEntered); const p = nested(t, 'priority', 'name').toLowerCase(); return (p.includes('critical') && age > 1) || (p.includes('high') && age > 3) || age > 7; });
+    if (atRisk.length === 0)
+        return 'No SLA breach risks.';
+    const lines = [`## SLA Breach Alerts (${atRisk.length})\n`, '| # | Summary | Priority | Age | Risk |', '|---|---------|----------|-----|------|'];
+    for (const t of atRisk.slice(0, 30)) {
+        const age = daysSince(t.dateEntered);
+        const p = nested(t, 'priority', 'name').toLowerCase();
+        lines.push(`| ${t.id} | ${String(t.summary ?? '').substring(0, 40)} | ${nested(t, 'priority', 'name')} | ${age}d | ${p.includes('critical') ? 'BREACH' : 'HIGH'} |`);
+    }
+    return lines.join('\n');
+});
+reg('dispatch_optimizer', async () => {
+    const api = getAPI();
+    const [unassigned, time] = await Promise.all([api.paginatedFetch('/service/tickets', "closedFlag=false AND resources=null", 'id,summary,priority/name,board/name', 100), api.paginatedFetch('/time/entries', `dateEntered>=[${daysAgo(7)}]`, 'id,actualHours,member/identifier', 2000)]);
+    const wl = {};
+    for (const e of time.items) {
+        const m = nested(e, 'member', 'identifier');
+        wl[m] = (wl[m] ?? 0) + num(e.actualHours);
+    }
+    const lines = [`## Dispatch Optimizer\n`, `**Unassigned:** ${unassigned.items.length}\n`];
+    const least = Object.entries(wl).sort((a, b) => a[1] - b[1]).slice(0, 5);
+    if (least.length > 0) {
+        lines.push('### Most Available (7d)', '| Member | Hours |', '|--------|-------|');
+        for (const [m, h] of least)
+            lines.push(`| ${m} | ${round2(h)}h |`);
+    }
+    if (unassigned.items.length > 0) {
+        lines.push('\n### Unassigned', '| # | Summary | Priority |', '|---|---------|----------|');
+        for (const t of unassigned.items.slice(0, 20))
+            lines.push(`| ${t.id} | ${String(t.summary ?? '').substring(0, 40)} | ${nested(t, 'priority', 'name')} |`);
+    }
+    return lines.join('\n');
+});
+reg('csat_report', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 90);
+    const r = await api.paginatedFetch('/service/surveys/results', `dateCreated>=[${daysAgo(days)}]`, undefined, 500);
+    if (r.items.length === 0)
+        return `No survey results in the last ${days} days.`;
+    const scores = r.items.map(x => num(x.totalPoints)).filter(s => s > 0);
+    return [`## CSAT Report (${days} days)\n`, `**Responses:** ${scores.length} | **Avg Score:** ${scores.length > 0 ? round2(scores.reduce((a, b) => a + b, 0) / scores.length) : 0}`].join('\n');
+});
+reg('cross_board_ticket_flow', async () => {
+    const api = getAPI();
+    const r = await api.paginatedFetch('/service/tickets', `closedDate>=[${daysAgo(30)}]`, 'id,board/name', 2000);
+    const bc = {};
+    for (const t of r.items) {
+        const b = nested(t, 'board', 'name');
+        bc[b] = (bc[b] ?? 0) + 1;
+    }
+    const lines = ['## Cross-Board Flow (30 days)\n', '| Board | Closed | % |', '|-------|--------|---|'];
+    for (const [b, c] of Object.entries(bc).sort((a, b) => b[1] - a[1]))
+        lines.push(`| ${b} | ${c} | ${round2((c / r.items.length) * 100)}% |`);
+    return lines.join('\n');
+});
+// ===========================================================================
+// INTELLIGENCE
+// ===========================================================================
+reg('ticket_triage_assist', async (params) => {
+    const api = getAPI();
+    const tid = num(params['ticket_id']);
+    if (!tid)
+        return 'Error: ticket_id required.';
+    const t = (await api.request({ path: `/service/tickets/${tid}`, method: 'GET' })).data;
+    const s = String(t.summary ?? '').toLowerCase();
+    let pri = 'Medium';
+    if (s.match(/down|outage|emergency/))
+        pri = 'Critical';
+    else if (s.match(/error|slow|not working/))
+        pri = 'High';
+    else if (s.match(/question|how to|request/))
+        pri = 'Low';
+    let cat = 'General';
+    if (s.match(/network|vpn|wifi/))
+        cat = 'Network';
+    else if (s.match(/email|outlook|365/))
+        cat = 'Email/Cloud';
+    else if (s.match(/printer|print/))
+        cat = 'Printer';
+    else if (s.match(/password|login|access/))
+        cat = 'Access';
+    else if (s.match(/server|backup/))
+        cat = 'Infrastructure';
+    return [`## Triage: #${tid} -- ${t.summary}\n`, '| Field | Current | Suggested |', '|-------|---------|-----------|', `| Priority | ${nested(t, 'priority', 'name')} | ${pri} |`, `| Category | ${nested(t, 'type', 'name')} | ${cat} |`, `| Board | ${nested(t, 'board', 'name')} | -- |`].join('\n');
+});
+reg('company_risk_assessment', async (params) => {
+    const api = getAPI();
+    const cid = num(params['company_id']);
+    if (!cid)
+        return 'Error: company_id required.';
+    const [open, agrs, time] = await Promise.all([api.count('/service/tickets', `company/id=${cid} AND closedFlag=false`), api.count('/finance/agreements', `company/id=${cid} AND cancelledFlag=false`), api.paginatedFetch('/time/entries', `company/id=${cid} AND dateEntered>=[${daysAgo(90)}]`, 'id,actualHours,billableOption', 1000)]);
+    let score = 100;
+    const factors = [];
+    if (open > 10) {
+        score -= 15;
+        factors.push(`${open} open tickets`);
+    }
+    if (agrs === 0) {
+        score -= 20;
+        factors.push('No agreements');
+    }
+    const th = time.items.reduce((s, e) => s + num(e.actualHours), 0);
+    const bh = time.items.filter(e => String(e.billableOption ?? '').toLowerCase().includes('billable')).reduce((s, e) => s + num(e.actualHours), 0);
+    if (th > 0 && bh / th < 0.5) {
+        score -= 10;
+        factors.push('Low billable ratio');
+    }
+    const risk = score >= 80 ? 'LOW' : score >= 60 ? 'MEDIUM' : 'HIGH';
+    const lines = [`## Risk Assessment: Company #${cid}\n`, `**Score:** ${Math.max(0, score)}/100 | **Level:** ${risk}\n`, '| Metric | Value |', '|--------|-------|', `| Open Tickets | ${open} |`, `| Agreements | ${agrs} |`, `| Hours (90d) | ${round2(th)}h (${round2(bh)}h billable) |`];
+    if (factors.length > 0) {
+        lines.push('\n### Risk Factors');
+        for (const f of factors)
+            lines.push(`- ${f}`);
+    }
+    return lines.join('\n');
+});
+reg('revenue_leakage_scan', async () => {
+    const api = getAPI();
+    const [ub, exp, na] = await Promise.all([api.paginatedFetch('/time/entries', "billableOption='Billable' AND invoiceFlag=false", 'id,actualHours', 1000), api.paginatedFetch('/finance/agreements', `cancelledFlag=false AND endDate<[${today()}]`, 'id,billAmount', 200), api.paginatedFetch('/time/entries', `billableOption='Billable' AND agreement=null AND dateEntered>=[${daysAgo(30)}]`, 'id,actualHours', 500)]);
+    return ['## Revenue Leakage Scan\n', '| Source | Volume | Impact |', '|--------|--------|--------|', `| Unbilled hours | ${round2(ub.items.reduce((s, e) => s + num(e.actualHours), 0))}h | High |`, `| Expired agreements | ${exp.items.length} ($${round2(exp.items.reduce((s, a) => s + num(a.billAmount), 0))}/mo) | High |`, `| No-agreement billable (30d) | ${round2(na.items.reduce((s, e) => s + num(e.actualHours), 0))}h | Medium |`].join('\n');
+});
+reg('recurring_issue_detector', async (params) => {
+    const api = getAPI();
+    const cid = num(params['company_id']);
+    if (!cid)
+        return 'Error: company_id required.';
+    const r = await api.paginatedFetch('/service/tickets', `company/id=${cid} AND dateEntered>=[${daysAgo(180)}]`, 'id,summary,type/name', 500);
+    const bt = {};
+    for (const t of r.items) {
+        const type = nested(t, 'type', 'name');
+        bt[type] = (bt[type] ?? 0) + 1;
+    }
+    const lines = [`## Recurring Issues: Company #${cid} (${r.items.length} tickets, 180 days)\n`, '| Type | Count |', '|------|-------|'];
+    for (const [k, v] of Object.entries(bt).sort((a, b) => b[1] - a[1]))
+        lines.push(`| ${k} | ${v} |`);
+    return lines.join('\n');
+});
+reg('company_onboarding_checklist', async (params) => {
+    const api = getAPI();
+    const cid = num(params['company_id']);
+    if (!cid)
+        return 'Error: company_id required.';
+    const [co, contacts, sites, configs, agrs] = await Promise.all([api.request({ path: `/company/companies/${cid}`, method: 'GET' }).catch(() => ({ data: {} })), api.count('/company/contacts', `company/id=${cid}`), api.paginatedFetch(`/company/companies/${cid}/sites`, undefined, 'id', 10), api.count('/company/configurations', `company/id=${cid}`), api.count('/finance/agreements', `company/id=${cid} AND cancelledFlag=false`)]);
+    const checks = [['Company record', co.data.id ? 'PASS' : 'FAIL'], ['Contacts', contacts > 0 ? 'PASS' : 'FAIL'], ['Sites', sites.items.length > 0 ? 'PASS' : 'FAIL'], ['Configurations', configs > 0 ? 'WARN' : 'WARN'], ['Agreement', agrs > 0 ? 'PASS' : 'FAIL']];
+    const pass = checks.filter(c => c[1] === 'PASS').length;
+    const lines = [`## Onboarding: ${co.data.name ?? `#${cid}`} (${pass}/${checks.length})\n`, '| Check | Status |', '|-------|--------|'];
+    for (const [item, status] of checks)
+        lines.push(`| ${item} | ${status} |`);
+    return lines.join('\n');
+});
+reg('similar_ticket_finder', async (params) => {
+    const api = getAPI();
+    const tid = num(params['ticket_id']);
+    if (!tid)
+        return 'Error: ticket_id required.';
+    const t = (await api.request({ path: `/service/tickets/${tid}`, method: 'GET' })).data;
+    const words = String(t.summary ?? '').split(/\s+/).filter(w => w.length > 4).slice(0, 3);
+    if (words.length === 0)
+        return 'Summary too short.';
+    const cond = words.map(w => `summary like '%${w}%'`).join(' OR ');
+    const r = await api.paginatedFetch('/service/tickets', `(${cond}) AND id!=${tid}`, 'id,summary,status/name,company/name,dateEntered', 50);
+    if (r.items.length === 0)
+        return 'No similar tickets found.';
+    const lines = [`## Similar to #${tid}: ${t.summary}\n`, '| # | Summary | Status | Company |', '|---|---------|--------|---------|'];
+    for (const s of r.items.slice(0, 20))
+        lines.push(`| ${s.id} | ${String(s.summary ?? '').substring(0, 50)} | ${nested(s, 'status', 'name')} | ${nested(s, 'company', 'name')} |`);
+    return lines.join('\n');
+});
+reg('escalation_risk_scorer', async () => {
+    const api = getAPI();
+    const r = await api.paginatedFetch('/service/tickets', 'closedFlag=false', 'id,summary,priority/name,dateEntered,lastUpdated,resources', 1000);
+    const scored = r.items.map(t => { let risk = 0; const age = daysSince(t.dateEntered); const stale = daysSince(t.lastUpdated); const p = nested(t, 'priority', 'name').toLowerCase(); if (p.includes('critical'))
+        risk += 40;
+    else if (p.includes('high'))
+        risk += 25; if (age > 14)
+        risk += 20;
+    else if (age > 7)
+        risk += 10; if (stale > 7)
+        risk += 20; if (!t.resources)
+        risk += 15; return { t, risk: Math.min(risk, 100) }; }).filter(s => s.risk >= 30).sort((a, b) => b.risk - a.risk);
+    if (scored.length === 0)
+        return 'No escalation risks.';
+    const lines = [`## Escalation Risk (${scored.length} tickets)\n`, '| # | Summary | Priority | Risk |', '|---|---------|----------|------|'];
+    for (const s of scored.slice(0, 30))
+        lines.push(`| ${s.t.id} | ${String(s.t.summary ?? '').substring(0, 40)} | ${nested(s.t, 'priority', 'name')} | ${s.risk}/100 |`);
+    return lines.join('\n');
+});
+reg('schedule_gap_analysis', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 14);
+    const e = await api.paginatedFetch('/schedule/entries', `dateStart>=[${today()}]`, 'id,member/identifier,hours', 2000);
+    const bm = {};
+    for (const x of e.items) {
+        const m = nested(x, 'member', 'identifier');
+        bm[m] = (bm[m] ?? 0) + num(x.hours);
+    }
+    const exp = days * 8 * 5 / 7;
+    const lines = [`## Schedule Gaps (next ${days} days)\n`, '| Member | Scheduled | Expected | Gap |', '|--------|-----------|----------|-----|'];
+    for (const [m, h] of Object.entries(bm).sort((a, b) => a[1] - b[1])) {
+        const g = round2(exp - h);
+        lines.push(`| ${m} | ${round2(h)}h | ${round2(exp)}h | ${g > 0 ? g + 'h under' : Math.abs(g) + 'h over'} |`);
+    }
+    return lines.join('\n');
+});
+reg('after_hours_impact_report', async () => {
+    const api = getAPI();
+    const r = await api.paginatedFetch('/service/tickets', `dateEntered>=[${daysAgo(30)}]`, 'id,summary,dateEntered,priority/name,company/name', 2000);
+    const ah = r.items.filter(t => { const h = new Date(t.dateEntered).getHours(); return h < 7 || h >= 18; });
+    if (ah.length === 0)
+        return 'No after-hours tickets (30 days).';
+    const lines = [`## After-Hours (${ah.length} of ${r.items.length}, ${round2((ah.length / r.items.length) * 100)}%)\n`, '| # | Summary | Priority | Created |', '|---|---------|----------|---------|'];
+    for (const t of ah.slice(0, 25))
+        lines.push(`| ${t.id} | ${String(t.summary ?? '').substring(0, 40)} | ${nested(t, 'priority', 'name')} | ${String(t.dateEntered ?? '').substring(0, 16)} |`);
+    return lines.join('\n');
+});
+reg('proactive_maintenance_alerts', async () => {
+    const api = getAPI();
+    const [configs, tickets] = await Promise.all([api.paginatedFetch('/company/configurations', 'activeFlag=true', 'id,name,company/name,type/name', 500), api.paginatedFetch('/service/tickets', `dateEntered>=[${daysAgo(90)}]`, 'id,configurations', 2000)]);
+    const ct = {};
+    for (const t of tickets.items) {
+        const cfgs = t.configurations;
+        if (Array.isArray(cfgs))
+            for (const c of cfgs)
+                ct[String(c.id)] = (ct[String(c.id)] ?? 0) + 1;
+    }
+    const atRisk = configs.items.filter(c => (ct[String(c.id)] ?? 0) >= 3).sort((a, b) => (ct[String(b.id)] ?? 0) - (ct[String(a.id)] ?? 0));
+    if (atRisk.length === 0)
+        return 'No configs with recurring issues.';
+    const lines = [`## Maintenance Alerts (${atRisk.length} configs, 3+ tickets/90d)\n`, '| Config | Company | Type | Tickets |', '|--------|---------|------|---------|'];
+    for (const c of atRisk.slice(0, 25))
+        lines.push(`| ${c.name} | ${nested(c, 'company', 'name')} | ${nested(c, 'type', 'name')} | ${ct[String(c.id)]} |`);
+    return lines.join('\n');
+});
+reg('knowledge_article_recommendation', async (params) => {
+    const api = getAPI();
+    const tid = num(params['ticket_id']);
+    if (!tid)
+        return 'Error: ticket_id required.';
+    const t = (await api.request({ path: `/service/tickets/${tid}`, method: 'GET' })).data;
+    const words = String(t.summary ?? '').split(/\s+/).filter(w => w.length > 3).slice(0, 4);
+    if (words.length === 0)
+        return 'Summary too short for KB search.';
+    const cond = words.map(w => `title like '%${w}%'`).join(' OR ');
+    const r = await api.paginatedFetch('/service/knowledgeBaseArticles', cond, 'id,title', 20);
+    if (r.items.length === 0)
+        return `No KB articles matching #${tid}.`;
+    const lines = [`## KB Recommendations for #${tid}\n`, '| ID | Title |', '|----|-------|'];
+    for (const a of r.items)
+        lines.push(`| ${a.id} | ${a.title} |`);
+    return lines.join('\n');
+});
+reg('resource_skill_matcher', async (params) => {
+    const api = getAPI();
+    const tid = num(params['ticket_id']);
+    if (!tid)
+        return 'Error: ticket_id required.';
+    const [t, members] = await Promise.all([api.request({ path: `/service/tickets/${tid}`, method: 'GET' }), api.paginatedFetch('/system/members', 'inactiveFlag=false', 'id,identifier,firstName,lastName,defaultDepartment/name', 200)]);
+    const lines = [`## Skill Match: #${tid}\n`, `**Board:** ${nested(t.data, 'board', 'name')} | **Type:** ${nested(t.data, 'type', 'name')}\n`, '| Member | Department |', '|--------|-----------|'];
+    for (const m of members.items.slice(0, 20))
+        lines.push(`| ${m.firstName} ${m.lastName} (${m.identifier}) | ${nested(m, 'defaultDepartment', 'name')} |`);
+    return lines.join('\n');
+});
+reg('configuration_lifecycle_tracker', async (params) => {
+    const api = getAPI();
+    const cid = params['company_id'] ? num(params['company_id']) : undefined;
+    const cond = cid ? `company/id=${cid} AND activeFlag=true` : 'activeFlag=true';
+    const r = await api.paginatedFetch('/company/configurations', cond, 'id,name,company/name,type/name,status/name,installationDate', 500);
+    const lines = [`## Configuration Lifecycle${cid ? ` (Company #${cid})` : ''}\n`, '| Name | Company | Type | Age |', '|------|---------|------|-----|'];
+    for (const c of r.items.slice(0, 50))
+        lines.push(`| ${c.name} | ${nested(c, 'company', 'name')} | ${nested(c, 'type', 'name')} | ${c.installationDate ? daysSince(c.installationDate) + 'd' : 'N/A'} |`);
+    return lines.join('\n');
+});
+reg('time_prediction_model', async (params) => {
+    const api = getAPI();
+    const tid = num(params['ticket_id']);
+    if (!tid)
+        return 'Error: ticket_id required.';
+    const t = (await api.request({ path: `/service/tickets/${tid}`, method: 'GET' })).data;
+    const type = nested(t, 'type', 'name');
+    const board = nested(t, 'board', 'name');
+    const sim = await api.paginatedFetch('/service/tickets', `closedFlag=true AND type/name='${type}' AND board/name='${board}'`, 'id,actualHours', 200);
+    const hrs = sim.items.map(s => num(s.actualHours)).filter(h => h > 0);
+    if (hrs.length < 3)
+        return `Not enough data (${hrs.length} similar tickets).`;
+    const avg = round2(hrs.reduce((a, b) => a + b, 0) / hrs.length);
+    const sorted = [...hrs].sort((a, b) => a - b);
+    const med = round2(sorted[Math.floor(sorted.length / 2)]);
+    return [`## Time Prediction: #${tid}\n`, `Based on ${hrs.length} similar (${type}, ${board}):\n`, '| Metric | Hours |', '|--------|-------|', `| Average | ${avg}h |`, `| Median | ${med}h |`, `| **Prediction** | **${med}h** |`].join('\n');
+});
+// ===========================================================================
+// PREMIUM ANALYTICS
+// ===========================================================================
+reg('agreement_profitability_analysis', async () => {
+    const api = getAPI();
+    const agrs = await api.paginatedFetch('/finance/agreements', 'cancelledFlag=false', 'id,name,company/name,billAmount', 200);
+    const res = await Promise.allSettled(agrs.items.slice(0, 30).map(async (a) => { const t = await api.paginatedFetch('/time/entries', `agreement/id=${a.id} AND dateEntered>=[${daysAgo(90)}]`, 'id,actualHours', 500); return { a, hours: t.items.reduce((s, e) => s + num(e.actualHours), 0), rev: num(a.billAmount) * 3 }; }));
+    const lines = ['## Agreement Profitability (90 days)\n', '| Agreement | Company | Revenue | Hours | $/Hour |', '|-----------|---------|---------|-------|--------|'];
+    for (const r of res) {
+        if (r.status !== 'fulfilled')
+            continue;
+        const { a, hours, rev } = r.value;
+        lines.push(`| ${a.name} | ${nested(a, 'company', 'name')} | $${round2(rev)} | ${round2(hours)}h | $${hours > 0 ? round2(rev / hours) : 0} |`);
+    }
+    return lines.join('\n');
+});
+reg('client_health_score', async (params) => {
+    const api = getAPI();
+    const cid = num(params['company_id']);
+    if (!cid)
+        return 'Error: company_id required.';
+    const [open, agrs, time] = await Promise.all([api.count('/service/tickets', `company/id=${cid} AND closedFlag=false`), api.count('/finance/agreements', `company/id=${cid} AND cancelledFlag=false`), api.paginatedFetch('/time/entries', `company/id=${cid} AND dateEntered>=[${daysAgo(90)}]`, 'id,actualHours', 1000)]);
+    let score = 70;
+    if (agrs > 0)
+        score += 15;
+    else
+        score -= 10;
+    if (open <= 5)
+        score += 5;
+    else if (open > 15)
+        score -= 15;
+    score = Math.max(0, Math.min(100, score));
+    return [`## Client Health: #${cid}\n`, `**Score:** ${score}/100 | **Level:** ${score >= 80 ? 'HEALTHY' : score >= 60 ? 'WATCH' : 'AT RISK'}\n`, '| Metric | Value |', '|--------|-------|', `| Open Tickets | ${open} |`, `| Agreements | ${agrs} |`, `| Hours (90d) | ${round2(time.items.reduce((s, e) => s + num(e.actualHours), 0))}h |`].join('\n');
+});
+reg('effective_hourly_rate', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 90);
+    const [agrs, time] = await Promise.all([api.paginatedFetch('/finance/agreements', 'cancelledFlag=false', 'id,name,company/name,billAmount', 200), api.paginatedFetch('/time/entries', `dateEntered>=[${daysAgo(days)}]`, 'id,actualHours,agreement/id', 5000)]);
+    const ah = {};
+    for (const e of time.items) {
+        const aid = e.agreement?.id;
+        if (aid)
+            ah[aid] = (ah[aid] ?? 0) + num(e.actualHours);
+    }
+    const lines = [`## Effective Hourly Rate (${days} days)\n`, '| Agreement | Company | MRR | Hours | $/Hour |', '|-----------|---------|-----|-------|--------|'];
+    for (const a of agrs.items.slice(0, 30)) {
+        const h = ah[a.id] ?? 0;
+        if (h === 0)
+            continue;
+        const rev = num(a.billAmount) * (days / 30);
+        lines.push(`| ${a.name} | ${nested(a, 'company', 'name')} | $${num(a.billAmount)} | ${round2(h)}h | $${round2(rev / h)} |`);
+    }
+    return lines.join('\n');
+});
+reg('qbr_data_pack', async (params) => {
+    const api = getAPI();
+    const cid = num(params['company_id']);
+    if (!cid)
+        return 'Error: company_id required.';
+    const [tickets, closed, time, agrs] = await Promise.all([api.count('/service/tickets', `company/id=${cid} AND dateEntered>=[${daysAgo(90)}]`), api.count('/service/tickets', `company/id=${cid} AND closedDate>=[${daysAgo(90)}]`), api.paginatedFetch('/time/entries', `company/id=${cid} AND dateEntered>=[${daysAgo(90)}]`, 'id,actualHours,billableOption', 2000), api.paginatedFetch('/finance/agreements', `company/id=${cid} AND cancelledFlag=false`, 'id,billAmount', 50)]);
+    const th = time.items.reduce((s, e) => s + num(e.actualHours), 0);
+    const bh = time.items.filter(e => String(e.billableOption ?? '').toLowerCase().includes('billable')).reduce((s, e) => s + num(e.actualHours), 0);
+    const mrr = agrs.items.reduce((s, a) => s + num(a.billAmount), 0);
+    return [`## QBR Data: Company #${cid} (90 days)\n`, '| Metric | Value |', '|--------|-------|', `| Tickets | ${tickets} |`, `| Closed | ${closed} |`, `| Hours | ${round2(th)}h (${round2(bh)}h billable) |`, `| MRR | $${round2(mrr)} |`, `| Quarterly Rev | $${round2(mrr * 3)} |`].join('\n');
+});
+reg('pipeline_revenue_forecast', async () => {
+    const api = getAPI();
+    const r = await api.paginatedFetch('/sales/opportunities', 'closedFlag=false', 'id,name,stage/name,totalSalesValue', 500);
+    const bs = {};
+    for (const o of r.items) {
+        const s = nested(o, 'stage', 'name');
+        if (!bs[s])
+            bs[s] = { count: 0, value: 0 };
+        bs[s].count++;
+        bs[s].value += num(o.totalSalesValue);
+    }
+    const total = r.items.reduce((s, o) => s + num(o.totalSalesValue), 0);
+    const lines = [`## Pipeline Forecast (${r.items.length} opps, $${round2(total)} total)\n`, '| Stage | Count | Value |', '|-------|-------|-------|'];
+    for (const [s, d] of Object.entries(bs).sort((a, b) => b[1].value - a[1].value))
+        lines.push(`| ${s} | ${d.count} | $${round2(d.value)} |`);
+    return lines.join('\n');
+});
+reg('project_portfolio_health', async () => {
+    const api = getAPI();
+    const r = await api.paginatedFetch('/project/projects', "status/name='Open'", 'id,name,company/name,budgetHours,actualHours,estimatedEnd', 200);
+    const lines = ['## Project Portfolio Health\n', '| Project | Company | Budget | Actual | % | Overdue |', '|---------|---------|--------|--------|---|---------|'];
+    for (const p of r.items) {
+        const b = num(p.budgetHours);
+        const a = num(p.actualHours);
+        const pct = b > 0 ? round2((a / b) * 100) : 0;
+        const od = p.estimatedEnd && new Date(p.estimatedEnd) < new Date() ? 'YES' : 'No';
+        lines.push(`| ${p.name} | ${nested(p, 'company', 'name')} | ${b}h | ${round2(a)}h | ${pct}% | ${od} |`);
+    }
+    return lines.join('\n');
+});
+reg('revenue_per_employee', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 90);
+    const [members, entries] = await Promise.all([api.count('/system/members', 'inactiveFlag=false'), api.paginatedFetch('/time/entries', `dateEntered>=[${daysAgo(days)}] AND billableOption='Billable'`, 'id,actualHours,member/identifier', 5000)]);
+    const bm = {};
+    for (const e of entries.items) {
+        const m = nested(e, 'member', 'identifier');
+        bm[m] = (bm[m] ?? 0) + num(e.actualHours);
+    }
+    const tot = entries.items.reduce((s, e) => s + num(e.actualHours), 0);
+    const lines = [`## Revenue Per Employee (${days} days)\n`, `**Members:** ${members} | **Billable:** ${round2(tot)}h | **Avg:** ${members > 0 ? round2(tot / members) : 0}h\n`, '| Member | Billable |', '|--------|----------|'];
+    for (const [m, h] of Object.entries(bm).sort((a, b) => b[1] - a[1]).slice(0, 20))
+        lines.push(`| ${m} | ${round2(h)}h |`);
+    return lines.join('\n');
+});
+reg('service_margin_analysis', async () => {
+    const api = getAPI();
+    const agrs = await api.paginatedFetch('/finance/agreements', 'cancelledFlag=false', 'id,type/name,billAmount', 200);
+    const bt = {};
+    for (const a of agrs.items) {
+        const t = nested(a, 'type', 'name');
+        if (!bt[t])
+            bt[t] = { count: 0, mrr: 0 };
+        bt[t].count++;
+        bt[t].mrr += num(a.billAmount);
+    }
+    const lines = ['## Service Margin Analysis\n', '| Type | Count | MRR | Avg |', '|------|-------|-----|-----|'];
+    for (const [t, d] of Object.entries(bt).sort((a, b) => b[1].mrr - a[1].mrr))
+        lines.push(`| ${t} | ${d.count} | $${round2(d.mrr)} | $${round2(d.mrr / d.count)} |`);
+    return lines.join('\n');
+});
+reg('customer_lifetime_value', async (params) => {
+    const api = getAPI();
+    const cid = num(params['company_id']);
+    if (!cid)
+        return 'Error: company_id required.';
+    const [agrs, inv] = await Promise.all([api.paginatedFetch('/finance/agreements', `company/id=${cid}`, 'id,billAmount,startDate,cancelledFlag', 100), api.paginatedFetch('/finance/invoices', `company/id=${cid}`, 'id,total', 500)]);
+    const totalInv = inv.items.reduce((s, i) => s + num(i.total), 0);
+    const mrr = agrs.items.filter(a => !a.cancelledFlag).reduce((s, a) => s + num(a.billAmount), 0);
+    const oldest = agrs.items.map(a => a.startDate).filter(Boolean).sort()[0];
+    const months = oldest ? Math.max(1, Math.floor(daysSince(oldest) / 30)) : 1;
+    return [`## CLV: Company #${cid}\n`, '| Metric | Value |', '|--------|-------|', `| Total Invoiced | $${round2(totalInv)} |`, `| Months | ${months} |`, `| MRR | $${round2(mrr)} |`, `| Avg Monthly | $${round2(totalInv / months)} |`].join('\n');
+});
+reg('company_offboarding_audit', async (params) => {
+    const api = getAPI();
+    const cid = num(params['company_id']);
+    if (!cid)
+        return 'Error: company_id required.';
+    const [open, agrs, configs, ub] = await Promise.all([api.count('/service/tickets', `company/id=${cid} AND closedFlag=false`), api.count('/finance/agreements', `company/id=${cid} AND cancelledFlag=false`), api.count('/company/configurations', `company/id=${cid} AND activeFlag=true`), api.paginatedFetch('/time/entries', `company/id=${cid} AND billableOption='Billable' AND invoiceFlag=false`, 'id,actualHours', 500)]);
+    const ubh = ub.items.reduce((s, e) => s + num(e.actualHours), 0);
+    const checks = [['Open tickets', open > 0 ? 'BLOCK' : 'CLEAR', open > 0 ? `Close ${open}` : 'None'], ['Agreements', agrs > 0 ? 'BLOCK' : 'CLEAR', agrs > 0 ? `Cancel ${agrs}` : 'None'], ['Configs', configs > 0 ? 'WARN' : 'CLEAR', configs > 0 ? `Deactivate ${configs}` : 'None'], ['Unbilled time', ubh > 0 ? 'BLOCK' : 'CLEAR', ubh > 0 ? `Invoice ${round2(ubh)}h` : 'None']];
+    const blockers = checks.filter(c => c[1] === 'BLOCK').length;
+    const lines = [`## Offboarding: #${cid}\n`, `**Status:** ${blockers > 0 ? 'BLOCKED' : 'READY'}\n`, '| Check | Status | Action |', '|-------|--------|--------|'];
+    for (const [item, st, act] of checks)
+        lines.push(`| ${item} | ${st} | ${act} |`);
+    return lines.join('\n');
+});
+reg('procurement_spend_analysis', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 365);
+    const r = await api.paginatedFetch('/procurement/purchaseorders', `dateEntered>=[${daysAgo(days)}]`, 'id,vendorCompany/name,total', 1000);
+    const bv = {};
+    for (const po of r.items) {
+        const v = nested(po, 'vendorCompany', 'name');
+        if (!bv[v])
+            bv[v] = { total: 0, count: 0 };
+        bv[v].total += num(po.total);
+        bv[v].count++;
+    }
+    const gt = Object.values(bv).reduce((s, d) => s + d.total, 0);
+    const lines = [`## Procurement Spend (${days} days, $${round2(gt)})\n`, '| Vendor | POs | Spend | % |', '|--------|-----|-------|---|'];
+    for (const [v, d] of Object.entries(bv).sort((a, b) => b[1].total - a[1].total).slice(0, 20))
+        lines.push(`| ${v} | ${d.count} | $${round2(d.total)} | ${round2((d.total / gt) * 100)}% |`);
+    return lines.join('\n');
+});
+reg('client_retention_analysis', async () => {
+    const api = getAPI();
+    const [active, agrs, recent] = await Promise.all([api.count('/company/companies', "status/name='Active'"), api.paginatedFetch('/finance/agreements', 'cancelledFlag=false', 'id,company/id', 500), api.paginatedFetch('/service/tickets', `dateEntered>=[${daysAgo(90)}]`, 'id,company/id', 2000)]);
+    const wa = new Set(agrs.items.map(a => nested(a, 'company', 'id'))).size;
+    const wr = new Set(recent.items.map(t => nested(t, 'company', 'id'))).size;
+    return ['## Client Retention\n', '| Metric | Value |', '|--------|-------|', `| Active Companies | ${active} |`, `| With Agreement | ${wa} (${round2((wa / active) * 100)}%) |`, `| Active (90d) | ${wr} (${round2((wr / active) * 100)}%) |`, `| Inactive | ${active - wr} |`].join('\n');
+});
+reg('profitability_leaderboard', async () => {
+    const api = getAPI();
+    const [agrs, time] = await Promise.all([api.paginatedFetch('/finance/agreements', 'cancelledFlag=false', 'id,company/id,company/name,billAmount', 500), api.paginatedFetch('/time/entries', `dateEntered>=[${daysAgo(90)}]`, 'id,actualHours,company/id,company/name', 5000)]);
+    const cd = {};
+    for (const a of agrs.items) {
+        const c = String(nested(a, 'company', 'id'));
+        if (!cd[c])
+            cd[c] = { name: nested(a, 'company', 'name'), mrr: 0, hours: 0 };
+        cd[c].mrr += num(a.billAmount);
+    }
+    for (const e of time.items) {
+        const c = String(nested(e, 'company', 'id'));
+        if (!cd[c])
+            cd[c] = { name: nested(e, 'company', 'name'), mrr: 0, hours: 0 };
+        cd[c].hours += num(e.actualHours);
+    }
+    const ranked = Object.values(cd).filter(d => d.mrr > 0 && d.hours > 0).map(d => ({ ...d, rate: round2((d.mrr * 3) / d.hours) })).sort((a, b) => b.rate - a.rate);
+    const lines = ['## Profitability Leaderboard (90 days)\n', '| Rank | Company | MRR | Hours | $/Hour |', '|------|---------|-----|-------|--------|'];
+    ranked.slice(0, 20).forEach((d, i) => lines.push(`| ${i + 1} | ${d.name} | $${round2(d.mrr)} | ${round2(d.hours)}h | $${d.rate} |`));
+    return lines.join('\n');
+});
+// ===========================================================================
+// CROSS-DOMAIN
+// ===========================================================================
+reg('entity_relationship_map', async (params) => {
+    const api = getAPI();
+    const cid = num(params['company_id']);
+    if (!cid)
+        return 'Error: company_id required.';
+    const [co, contacts, tickets, agrs, configs, projects] = await Promise.all([api.request({ path: `/company/companies/${cid}`, method: 'GET' }).catch(() => ({ data: {} })), api.count('/company/contacts', `company/id=${cid}`), api.count('/service/tickets', `company/id=${cid}`), api.count('/finance/agreements', `company/id=${cid}`), api.count('/company/configurations', `company/id=${cid}`), api.count('/project/projects', `company/id=${cid}`)]);
+    return [`## Entity Map: ${co.data.name ?? `#${cid}`}\n`, '```', `${co.data.name ?? cid}`, `  +-- Contacts: ${contacts}`, `  +-- Tickets: ${tickets}`, `  +-- Agreements: ${agrs}`, `  +-- Configs: ${configs}`, `  +-- Projects: ${projects}`, '```'].join('\n');
+});
+reg('ticket_handoff_analysis', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 30);
+    const r = await api.paginatedFetch('/service/tickets', `closedDate>=[${daysAgo(days)}]`, 'id,resources', 2000);
+    const multi = r.items.filter(t => String(t.resources ?? '').includes(','));
+    return [`## Ticket Handoffs (${days} days)\n`, `**Closed:** ${r.items.length} | **Multi-assigned:** ${multi.length} (${round2((multi.length / Math.max(r.items.length, 1)) * 100)}%)`].join('\n');
+});
+reg('company_financial_summary', async (params) => {
+    const api = getAPI();
+    const cid = num(params['company_id']);
+    if (!cid)
+        return 'Error: company_id required.';
+    const [agrs, inv, time] = await Promise.all([api.paginatedFetch('/finance/agreements', `company/id=${cid} AND cancelledFlag=false`, 'id,billAmount', 50), api.paginatedFetch('/finance/invoices', `company/id=${cid} AND date>=[${daysAgo(90)}]`, 'id,total', 200), api.paginatedFetch('/time/entries', `company/id=${cid} AND dateEntered>=[${daysAgo(90)}]`, 'id,actualHours', 1000)]);
+    return [`## Financial Summary: #${cid} (90 days)\n`, '| Metric | Value |', '|--------|-------|', `| MRR | $${round2(agrs.items.reduce((s, a) => s + num(a.billAmount), 0))} |`, `| Agreements | ${agrs.items.length} |`, `| Invoiced | $${round2(inv.items.reduce((s, i) => s + num(i.total), 0))} |`, `| Hours | ${round2(time.items.reduce((s, e) => s + num(e.actualHours), 0))}h |`].join('\n');
+});
+reg('new_client_onboarding_status', async (params) => {
+    const api = getAPI();
+    const days = num(params['days'], 30);
+    const r = await api.paginatedFetch('/company/companies', `dateEntered>=[${daysAgo(days)}]`, 'id,name,status/name,dateEntered', 100);
+    if (r.items.length === 0)
+        return `No new companies in ${days} days.`;
+    const lines = [`## New Clients (${days} days, ${r.items.length})\n`, '| Company | Status | Added | Age |', '|---------|--------|-------|-----|'];
+    for (const c of r.items)
+        lines.push(`| ${c.name} | ${nested(c, 'status', 'name')} | ${String(c.dateEntered ?? '').substring(0, 10)} | ${daysSince(c.dateEntered)}d |`);
+    return lines.join('\n');
+});
+reg('board_health_dashboard', async (params) => {
+    const api = getAPI();
+    const bid = num(params['board_id']);
+    if (!bid)
+        return 'Error: board_id required.';
+    const [board, open, closed] = await Promise.all([api.request({ path: `/service/boards/${bid}`, method: 'GET' }).catch(() => ({ data: {} })), api.paginatedFetch('/service/tickets', `board/id=${bid} AND closedFlag=false`, 'id,priority/name,dateEntered', 1000), api.paginatedFetch('/service/tickets', `board/id=${bid} AND closedDate>=[${daysAgo(30)}]`, 'id', 1000)]);
+    const avgAge = open.items.length > 0 ? round2(open.items.reduce((s, t) => s + daysSince(t.dateEntered), 0) / open.items.length) : 0;
+    const bp = {};
+    for (const t of open.items) {
+        const p = nested(t, 'priority', 'name');
+        bp[p] = (bp[p] ?? 0) + 1;
+    }
+    const lines = [`## Board Health: ${board.data.name ?? `#${bid}`}\n`, '| Metric | Value |', '|--------|-------|', `| Open | ${open.items.length} |`, `| Closed (30d) | ${closed.items.length} |`, `| Avg Age | ${avgAge}d |`, '', '### By Priority', '| Priority | Count |', '|----------|-------|'];
+    for (const [p, c] of Object.entries(bp).sort((a, b) => b[1] - a[1]))
+        lines.push(`| ${p} | ${c} |`);
+    return lines.join('\n');
+});
+//# sourceMappingURL=analytics-extended.js.map