@trillboards/cli 0.1.0

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
+
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/dist/base-command.d.ts

@@ -0,0 +1,20 @@
+import { Command } from '@oclif/core';
+import { type OutputFormat } from './output.js';
+export declare abstract class BaseCommand extends Command {
+    static enableJsonFlag: boolean;
+    static baseFlags: {
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    private parsedFlags?;
+    protected catch(error: Error & {
+        exitCode?: number;
+    }): Promise<void>;
+    protected getApiKey(): string;
+    protected getBaseUrl(): string;
+    protected getFormat(): OutputFormat;
+    protected output(data: unknown): void;
+    protected parseGlobalFlags(): Promise<void>;
+    protected setParsedFlags(flags: Record<string, unknown>): void;
+}

package/dist/base-command.js

@@ -0,0 +1,60 @@
+import { Command, Flags } from '@oclif/core';
+import { readConfig } from './config.js';
+import { TrillboardsApiError } from './http.js';
+import { formatOutput } from './output.js';
+export class BaseCommand extends Command {
+    static enableJsonFlag = false;
+    static baseFlags = {
+        'api-key': Flags.string({
+            description: 'API key (or set TRILLBOARDS_API_KEY env var)',
+            env: 'TRILLBOARDS_API_KEY',
+        }),
+        'base-url': Flags.string({
+            default: 'https://api.trillboards.com',
+            description: 'API base URL',
+        }),
+        format: Flags.string({
+            description: 'Output format',
+            options: ['json', 'table', 'yaml'],
+        }),
+    };
+    parsedFlags;
+    async catch(error) {
+        if (error instanceof TrillboardsApiError) {
+            this.error(`${error.message}\n\nRun: trillboards errors ${error.code}`, { exit: 1 });
+        }
+        throw error;
+    }
+    getApiKey() {
+        const flags = this.parsedFlags;
+        return (flags?.['api-key'] ||
+            process.env.TRILLBOARDS_API_KEY ||
+            readConfig()?.api_key ||
+            '');
+    }
+    getBaseUrl() {
+        const flags = this.parsedFlags;
+        return flags?.['base-url'] || 'https://api.trillboards.com';
+    }
+    getFormat() {
+        const flags = this.parsedFlags;
+        const explicit = flags?.format;
+        if (explicit)
+            return explicit;
+        const configFormat = readConfig()?.default_format;
+        if (configFormat)
+            return configFormat;
+        return process.stdout.isTTY ? 'table' : 'json';
+    }
+    output(data) {
+        const formatted = formatOutput(data, this.getFormat());
+        this.log(formatted);
+    }
+    async parseGlobalFlags() {
+        // oclif parses flags in run() — this is called from each command's run() after parse()
+        // Individual commands set parsedFlags after calling this.parse()
+    }
+    setParsedFlags(flags) {
+        this.parsedFlags = flags;
+    }
+}

package/dist/commands/api.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../base-command.js';
+export default class Api extends BaseCommand {
+    static args: {
+        method: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        path: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        jq: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/api.js

@@ -0,0 +1,80 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../base-command.js';
+import { apiRequest } from '../http.js';
+export default class Api extends BaseCommand {
+    static args = {
+        method: Args.string({
+            description: 'HTTP method (GET, POST, PUT, PATCH, DELETE)',
+            required: true,
+        }),
+        path: Args.string({
+            description: 'API path (e.g. /v1/partner/screens)',
+            required: true,
+        }),
+    };
+    static description = 'Make raw API requests (like gh api)';
+    static examples = [
+        '<%= config.bin %> api GET /v1/partner/screens',
+        '<%= config.bin %> api POST /v1/partner/device --data \'{"name":"test"}\'',
+        '<%= config.bin %> api GET /v1/partner/info --jq partner_name',
+    ];
+    static flags = {
+        data: Flags.string({ char: 'd', description: 'Request body (JSON string)' }),
+        jq: Flags.string({ description: 'JSON path expression to extract (e.g. "data.items" or "name")' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Api);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey) {
+            this.error('Not logged in. Run: trillboards login', { exit: 1 });
+        }
+        const method = args.method.toUpperCase();
+        const validMethods = ['DELETE', 'GET', 'PATCH', 'POST', 'PUT'];
+        if (!validMethods.includes(method)) {
+            this.error(`Invalid HTTP method: ${method}. Must be one of: ${validMethods.join(', ')}`, { exit: 1 });
+        }
+        let body;
+        if (flags.data) {
+            try {
+                body = JSON.parse(flags.data);
+            }
+            catch {
+                this.error('Invalid JSON in --data flag.', { exit: 1 });
+            }
+        }
+        const baseUrl = this.getBaseUrl();
+        const result = await apiRequest(method, args.path, { apiKey, baseUrl, body });
+        // Apply jq-like path extraction
+        if (flags.jq) {
+            const extracted = jqPath(result, flags.jq);
+            this.output(extracted);
+        }
+        else {
+            this.output(result);
+        }
+    }
+}
+/**
+ * Simple jq-like path evaluator.
+ * Supports dot-separated paths: "data.items", "name", "data.0.id"
+ */
+function jqPath(data, path) {
+    const parts = path.split('.');
+    let current = data;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== 'object')
+            return undefined;
+        // Array index
+        const index = Number.parseInt(part, 10);
+        if (Array.isArray(current) && !Number.isNaN(index)) {
+            current = current[index];
+        }
+        else {
+            current = current[part];
+        }
+    }
+    return current;
+}

package/dist/commands/audience/live.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base-command.js';
+export default class AudienceLive extends BaseCommand {
+    static args: {
+        screen_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        interval: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private fetchAudience;
+    private renderAudience;
+}

package/dist/commands/audience/live.js

@@ -0,0 +1,117 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { clearScreen, colorize, relativeTime } from '../../format-helpers.js';
+import { apiRequest } from '../../http.js';
+export default class AudienceLive extends BaseCommand {
+    static args = {
+        screen_id: Args.string({
+            description: 'Screen ID to monitor',
+            required: true,
+        }),
+    };
+    static description = 'Real-time audience sensing data for a screen';
+    static examples = [
+        '<%= config.bin %> audience live scr_abc123',
+        '<%= config.bin %> audience live scr_abc123 --format json',
+        '<%= config.bin %> audience live scr_abc123 --interval 3',
+    ];
+    static flags = {
+        interval: Flags.integer({
+            default: 5,
+            description: 'Polling interval in seconds',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AudienceLive);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey) {
+            this.error('Not logged in. Run: trillboards login', { exit: 1 });
+        }
+        const baseUrl = this.getBaseUrl();
+        const screenId = args.screen_id;
+        const format = this.getFormat();
+        const intervalSec = flags.interval ?? 5;
+        // Single fetch for JSON format
+        if (format === 'json' && !process.stdout.isTTY) {
+            const data = await this.fetchAudience(apiKey, baseUrl, screenId);
+            this.output(data);
+            return;
+        }
+        let lastFetchTime = new Date();
+        const render = async () => {
+            try {
+                const data = await this.fetchAudience(apiKey, baseUrl, screenId);
+                lastFetchTime = new Date();
+                if (format === 'json') {
+                    this.log(JSON.stringify({ ...data, fetched_at: lastFetchTime.toISOString() }));
+                    return;
+                }
+                clearScreen();
+                this.renderAudience(screenId, data, intervalSec, lastFetchTime);
+            }
+            catch (error) {
+                if (format !== 'json') {
+                    clearScreen();
+                }
+                const msg = error instanceof Error ? error.message : String(error);
+                if (msg.includes('404') || msg.includes('not found')) {
+                    this.log(colorize(`Screen: ${screenId} -- Live Audience`, 'bold'));
+                    this.log('');
+                    this.log(colorize('Audience sensing not available for this screen.', 'dim'));
+                    this.log('This screen may not have sensing hardware configured.');
+                    this.log('');
+                    this.log(colorize(`Retrying every ${intervalSec}s... Press Ctrl+C to stop`, 'dim'));
+                }
+                else {
+                    this.log(colorize(`Error: ${msg}`, 'red'));
+                    this.log('Retrying...');
+                }
+            }
+        };
+        // Initial render
+        await render();
+        // Schedule refresh
+        const timer = setInterval(() => {
+            render().catch(() => {
+                // Errors handled inside render
+            });
+        }, intervalSec * 1000);
+        // Clean exit
+        const cleanup = () => {
+            clearInterval(timer);
+            this.log('\nStopped audience monitoring.');
+            process.exit(0);
+        };
+        process.on('SIGINT', cleanup);
+        process.on('SIGTERM', cleanup);
+        // Keep process alive
+        await new Promise(() => {
+            // Never resolves — exits via signal handler
+        });
+    }
+    async fetchAudience(apiKey, baseUrl, screenId) {
+        return apiRequest('GET', `/v1/partner/audience/live/${screenId}`, { apiKey, baseUrl });
+    }
+    renderAudience(screenId, data, intervalSec, lastFetch) {
+        this.log(colorize(`Screen: ${screenId} -- Live Audience`, 'bold'));
+        this.log('');
+        const labelW = 14;
+        const lines = [
+            ['Faces:', String(data.faces ?? '?')],
+            ['Attention:', data.attention != null ? data.attention.toFixed(2) : '?'],
+            ['Mood:', data.mood ?? '?'],
+            ['Dwell:', data.dwell_seconds != null ? `${data.dwell_seconds}s` : '?'],
+            ['Intent:', data.intent ?? '?'],
+            ['Density:', String(data.density ?? '?')],
+            ['Income:', data.income ?? '?'],
+            ['Segment:', data.segment ?? '?'],
+        ];
+        for (const [label, value] of lines) {
+            this.log(`${label.padEnd(labelW)} ${value}`);
+        }
+        this.log('');
+        this.log(colorize(`Last updated: ${relativeTime(lastFetch)} (refreshing every ${intervalSec}s)`, 'dim'));
+        this.log(colorize('Press Ctrl+C to stop', 'dim'));
+    }
+}

package/dist/commands/billing/usage.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base-command.js';
+export default class BillingUsage extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        breakdown: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private renderBreakdown;
+}

package/dist/commands/billing/usage.js

@@ -0,0 +1,92 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { colorize, formatCount, formatCurrency } from '../../format-helpers.js';
+import { apiRequest } from '../../http.js';
+export default class BillingUsage extends BaseCommand {
+    static description = 'Billing usage details with optional per-product breakdown';
+    static examples = [
+        '<%= config.bin %> billing usage',
+        '<%= config.bin %> billing usage --breakdown',
+        '<%= config.bin %> billing usage --format json',
+    ];
+    static flags = {
+        breakdown: Flags.boolean({
+            default: false,
+            description: 'Show per-product breakdown table',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(BillingUsage);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey) {
+            this.error('Not logged in. Run: trillboards login', { exit: 1 });
+        }
+        const baseUrl = this.getBaseUrl();
+        const format = this.getFormat();
+        const data = await apiRequest('GET', '/v1/partner/billing/usage-summary', { apiKey, baseUrl });
+        if (format === 'json') {
+            this.output(data);
+            return;
+        }
+        this.log(colorize('Billing Usage', 'bold'));
+        this.log('');
+        this.log(`Plan:           ${data.current_plan ?? 'N/A'}`);
+        if (data.period_start && data.period_end) {
+            this.log(`Period:         ${data.period_start} to ${data.period_end}`);
+        }
+        if (data.screens_active != null) {
+            const limit = data.screens_limit != null ? `/${data.screens_limit}` : '';
+            this.log(`Screens:        ${data.screens_active}${limit}`);
+        }
+        if (data.impressions_used != null) {
+            const limit = data.impressions_limit ? `/${formatCount(data.impressions_limit)}` : '';
+            this.log(`Impressions:    ${formatCount(data.impressions_used)}${limit}`);
+            if (data.impressions_limit && data.impressions_used > data.impressions_limit) {
+                const overage = data.impressions_used - data.impressions_limit;
+                this.log(colorize(`  Overage:      ${formatCount(overage)} impressions over limit`, 'yellow'));
+                if (data.overage_rate != null) {
+                    this.log(`  Overage Rate: ${formatCurrency(data.overage_rate)}/1000`);
+                }
+            }
+        }
+        if (data.total_cost != null) {
+            this.log(`Total Cost:     ${formatCurrency(data.total_cost)}`);
+        }
+        // Breakdown table
+        if (flags.breakdown) {
+            this.log('');
+            this.renderBreakdown(data.products ?? []);
+        }
+        if (data.next_billing_date) {
+            this.log('');
+            this.log(`Next billing date: ${data.next_billing_date}`);
+        }
+    }
+    renderBreakdown(products) {
+        this.log(colorize('Per-Product Breakdown', 'bold'));
+        this.log('');
+        if (products.length === 0) {
+            this.log('  No product breakdown available.');
+            return;
+        }
+        const nameW = 28;
+        const qtyW = 14;
+        const unitW = 14;
+        const costW = 14;
+        this.log([
+            'Product'.padEnd(nameW),
+            'Quantity'.padEnd(qtyW),
+            'Unit'.padEnd(unitW),
+            'Cost'.padEnd(costW),
+        ].join('  '));
+        this.log('-'.repeat(nameW + qtyW + unitW + costW + 6));
+        for (const product of products) {
+            const name = (product.name ?? 'Unknown').slice(0, nameW).padEnd(nameW);
+            const qty = product.quantity != null ? formatCount(product.quantity).padEnd(qtyW) : 'N/A'.padEnd(qtyW);
+            const unit = (product.unit ?? '').padEnd(unitW);
+            const cost = product.cost != null ? formatCurrency(product.cost).padEnd(costW) : 'N/A'.padEnd(costW);
+            this.log(`${name}  ${qty}  ${unit}  ${cost}`);
+        }
+    }
+}

package/dist/commands/billing.d.ts

@@ -0,0 +1,6 @@
+import { BaseCommand } from '../base-command.js';
+export default class Billing extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/billing.js

@@ -0,0 +1,49 @@
+import { BaseCommand } from '../base-command.js';
+import { colorize, formatCount, formatCurrency } from '../format-helpers.js';
+import { apiRequest } from '../http.js';
+export default class Billing extends BaseCommand {
+    static description = 'Billing summary — current plan and usage';
+    static examples = [
+        '<%= config.bin %> billing',
+        '<%= config.bin %> billing --format json',
+    ];
+    async run() {
+        const { flags } = await this.parse(Billing);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey) {
+            this.error('Not logged in. Run: trillboards login', { exit: 1 });
+        }
+        const baseUrl = this.getBaseUrl();
+        const format = this.getFormat();
+        const data = await apiRequest('GET', '/v1/partner/billing/usage-summary', { apiKey, baseUrl });
+        if (format === 'json') {
+            this.output(data);
+            return;
+        }
+        this.log(colorize('Billing Summary', 'bold'));
+        this.log('');
+        this.log(`Plan:           ${data.current_plan ?? 'N/A'}`);
+        if (data.screens_active != null && data.screens_limit != null) {
+            this.log(`Screens:        ${data.screens_active}/${data.screens_limit}`);
+        }
+        else if (data.screens_active != null) {
+            this.log(`Screens:        ${data.screens_active}`);
+        }
+        if (data.impressions_used != null) {
+            const limit = data.impressions_limit ? `/${formatCount(data.impressions_limit)}` : '';
+            this.log(`Impressions:    ${formatCount(data.impressions_used)}${limit}`);
+        }
+        if (data.total_cost != null) {
+            this.log(`Current Cost:   ${formatCurrency(data.total_cost)}`);
+        }
+        if (data.period_start && data.period_end) {
+            this.log(`Period:         ${data.period_start} to ${data.period_end}`);
+        }
+        if (data.next_billing_date) {
+            this.log(`Next Billing:   ${data.next_billing_date}`);
+        }
+        this.log('');
+        this.log('For detailed breakdown: trillboards billing usage --breakdown');
+    }
+}

package/dist/commands/debug.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../base-command.js';
+export default class Debug extends BaseCommand {
+    static args: {
+        screen_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+    private renderDiagnostic;
+}

package/dist/commands/debug.js

@@ -0,0 +1,156 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../base-command.js';
+import { colorFillRate, colorize, formatCount, formatCurrency, relativeTime } from '../format-helpers.js';
+import { apiRequest } from '../http.js';
+export default class Debug extends BaseCommand {
+    static args = {
+        screen_id: Args.string({
+            description: 'Screen ID to diagnose',
+            required: true,
+        }),
+    };
+    static description = 'Diagnose a screen — status, performance, audience, issues';
+    static examples = [
+        '<%= config.bin %> debug scr_abc123',
+        '<%= config.bin %> debug scr_abc123 --format json',
+    ];
+    async run() {
+        const { args, flags } = await this.parse(Debug);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey) {
+            this.error('Not logged in. Run: trillboards login', { exit: 1 });
+        }
+        const baseUrl = this.getBaseUrl();
+        const screenId = args.screen_id;
+        const format = this.getFormat();
+        // Make 4 parallel API calls
+        const [healthResult, analyticsResult, audienceResult, fleetResult] = await Promise.allSettled([
+            apiRequest('GET', '/v1/partner/connect/health', { apiKey, baseUrl }),
+            apiRequest('GET', `/v1/partner/screens/${screenId}/analytics`, {
+                apiKey,
+                baseUrl,
+                params: { period: '1d' },
+            }),
+            apiRequest('GET', `/v1/partner/audience/live/${screenId}`, { apiKey, baseUrl }),
+            apiRequest('GET', '/v1/partner/fleet/analytics', { apiKey, baseUrl }),
+        ]);
+        // Extract screen from health list
+        const health = healthResult.status === 'fulfilled' ? healthResult.value : null;
+        const screen = health?.screens?.find((s) => s.screen_id === screenId || s.name === screenId);
+        const analytics = analyticsResult.status === 'fulfilled' ? analyticsResult.value : null;
+        const audience = audienceResult.status === 'fulfilled' ? audienceResult.value : null;
+        const fleet = fleetResult.status === 'fulfilled' ? fleetResult.value : null;
+        if (format === 'json') {
+            this.output({
+                audience: audience ?? null,
+                fleet: fleet ?? null,
+                health: screen ?? null,
+                screen_analytics: analytics ?? null,
+                screen_id: screenId,
+            });
+            return;
+        }
+        this.renderDiagnostic(screenId, screen, analytics, audience, fleet);
+    }
+    renderDiagnostic(screenId, screen, analytics, audience, fleet) {
+        const screenName = screen?.name ?? screenId;
+        this.log(colorize(`Screen: ${screenName} (${screenId})`, 'bold'));
+        this.log('');
+        const issues = [];
+        const suggestions = [];
+        // STATUS
+        if (screen) {
+            const status = screen.status?.toLowerCase() ?? 'unknown';
+            if (status === 'online') {
+                const hbText = screen.last_heartbeat ? relativeTime(screen.last_heartbeat) : 'unknown';
+                this.log(`STATUS:      ${colorize('\u2713', 'green')} Online (last heartbeat ${hbText})`);
+            }
+            else {
+                this.log(`STATUS:      ${colorize('\u2717', 'red')} ${screen.status ?? 'Offline'}`);
+                issues.push('Screen is offline');
+                suggestions.push('Check device power and network connectivity');
+            }
+        }
+        else {
+            this.log(`STATUS:      ${colorize('\u2013', 'yellow')} Could not fetch health data`);
+        }
+        // FILL RATE
+        if (analytics?.fill_rate != null) {
+            const networkAvg = fleet?.fill_rate ?? 0;
+            const diff = networkAvg > 0 ? analytics.fill_rate - networkAvg : 0;
+            if (analytics.fill_rate >= 70) {
+                this.log(`FILL RATE:   ${colorize('\u2713', 'green')} ${colorFillRate(analytics.fill_rate)} (network avg: ${networkAvg}%)`);
+            }
+            else {
+                const symbol = analytics.fill_rate >= 50 ? '\u26A0' : '\u2717';
+                const color = analytics.fill_rate >= 50 ? 'yellow' : 'red';
+                this.log(`FILL RATE:   ${colorize(symbol, color)} ${colorFillRate(analytics.fill_rate)} (network avg: ${networkAvg}%)`);
+                if (diff < -10) {
+                    issues.push(`Fill rate below network average by ${Math.abs(Math.round(diff))} points`);
+                    suggestions.push('Run: trillboards fill-rate --by partner');
+                }
+            }
+        }
+        else {
+            this.log(`FILL RATE:   ${colorize('\u2013', 'yellow')} Not available`);
+        }
+        // IMPRESSIONS
+        if (analytics?.impressions != null) {
+            const fleetAvgImpressions = fleet?.impressions ?? 0;
+            if (analytics.impressions > 0) {
+                this.log(`IMPRESSIONS: ${colorize('\u2713', 'green')} ${formatCount(analytics.impressions)} today`);
+            }
+            else {
+                this.log(`IMPRESSIONS: ${colorize('\u2717', 'red')} 0 today`);
+                issues.push('No impressions recorded today');
+                if (fleetAvgImpressions > 0) {
+                    suggestions.push('Check if programmatic partners are active');
+                }
+            }
+        }
+        else {
+            this.log(`IMPRESSIONS: ${colorize('\u2013', 'yellow')} Not available`);
+        }
+        // LAST AD
+        if (screen?.last_ad_at) {
+            const lastAdTime = relativeTime(screen.last_ad_at);
+            this.log(`LAST AD:     ${colorize('\u2713', 'green')} ${lastAdTime}`);
+        }
+        else {
+            this.log(`LAST AD:     ${colorize('\u2013', 'yellow')} Not available`);
+        }
+        // AUDIENCE
+        if (audience) {
+            const facesStr = audience.faces != null ? String(audience.faces) : '?';
+            const attnStr = audience.attention != null ? audience.attention.toFixed(2) : '?';
+            this.log(`AUDIENCE:    ${colorize('\u2713', 'green')} ${facesStr} faces, attention ${attnStr}`);
+        }
+        else {
+            this.log(`AUDIENCE:    ${colorize('\u2013', 'dim')} Not available (no sensing configured)`);
+        }
+        // REVENUE
+        if (analytics?.revenue != null && analytics.revenue > 0) {
+            this.log(`REVENUE:     ${colorize('\u2713', 'green')} ${formatCurrency(analytics.revenue)} today`);
+        }
+        // Issues summary
+        this.log('');
+        if (issues.length > 0) {
+            this.log(colorize('ISSUES FOUND:', 'yellow'));
+            for (const issue of issues) {
+                this.log(`  ${colorize('\u26A0', 'yellow')} ${issue}`);
+            }
+        }
+        else {
+            this.log(colorize('No issues found.', 'green'));
+        }
+        if (suggestions.length > 0) {
+            this.log('');
+            this.log(colorize('SUGGESTED FIXES:', 'bold'));
+            for (const suggestion of suggestions) {
+                this.log(`  ${suggestion}`);
+            }
+            this.log(`  Run: trillboards api GET /v1/partner/screens/${screenId}/programmatic-settings`);
+        }
+    }
+}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,6 @@
+import { BaseCommand } from '../base-command.js';
+export default class Doctor extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}