@formant/formant-cli 0.1.0

package/dist/commands/fleets/list.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base-command.js';
+export default class FleetsList extends BaseCommand<typeof FleetsList> {
+    static description: string;
+    static examples: string[];
+    static summary: string;
+    run(): Promise<{
+        items: unknown[];
+    }>;
+}

package/dist/commands/fleets/list.js

@@ -0,0 +1,27 @@
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class FleetsList extends BaseCommand {
+    static description = `List all device groups (fleets) in your organization.
+
+Device groups allow you to organize and manage sets of devices together.`;
+    static examples = [
+        '<%= config.bin %> fleets list',
+        '<%= config.bin %> fleets list --json',
+    ];
+    static summary = 'List device groups';
+    async run() {
+        const result = await this.api('admin', 'groups', { method: 'GET' });
+        if (!this.jsonEnabled()) {
+            const columns = [
+                { key: 'name', label: 'NAME', width: 30 },
+                { key: 'id', label: 'ID', width: 40 },
+                { key: 'description', label: 'DESCRIPTION', width: 40 },
+            ];
+            this.log(`\nFleets (Device Groups) (${this.env}):\n`);
+            this.log(formatTable(result.items ?? [], columns));
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/fleets/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/fleets/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAc,WAAW,EAAC,MAAM,yBAAyB,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAA8B;IACpE,MAAM,CAAU,WAAW,GAAG;;yEAEyC,CAAA;IAEvE,MAAM,CAAU,QAAQ,GAAG;QACzB,+BAA+B;QAC/B,sCAAsC;KACvC,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,oBAAoB,CAAA;IAEvC,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,OAAO,EACP,QAAQ,EACR,EAAC,MAAM,EAAE,KAAK,EAAC,CAChB,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,GAAa;gBACxB,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAC;gBACvC,EAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAC;gBACnC,EAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,EAAC;aACtD,CAAA;YAED,IAAI,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YACrD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;YAClD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC"}

package/dist/commands/investigations/analytics.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base-command.js';
+export default class InvestigationsAnalytics extends BaseCommand<typeof InvestigationsAnalytics> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        end: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'group-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        interval: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        start: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static summary: string;
+    run(): Promise<{
+        data: unknown[];
+    }>;
+}

package/dist/commands/investigations/analytics.js

@@ -0,0 +1,69 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class InvestigationsAnalytics extends BaseCommand {
+    static description = `Get investigation analytics with time-series data.
+
+Returns aggregated analytics about investigation runs over a time range,
+optionally grouped by result type or signal type.`;
+    static examples = [
+        '<%= config.bin %> investigations analytics --start 2026-01-01 --end 2026-02-01',
+        '<%= config.bin %> investigations analytics --start 2026-01-01 --end 2026-02-01 --interval hourly',
+        '<%= config.bin %> investigations analytics --start 2026-01-01 --end 2026-02-01 --group-by resultType --json',
+    ];
+    static flags = {
+        end: Flags.string({
+            description: 'End time (ISO 8601)',
+            required: true,
+        }),
+        'group-by': Flags.string({
+            description: 'Group results by',
+            options: ['resultType', 'signalType'],
+        }),
+        interval: Flags.string({
+            default: 'daily',
+            description: 'Time interval for aggregation',
+            options: ['daily', 'hourly'],
+        }),
+        start: Flags.string({
+            description: 'Start time (ISO 8601)',
+            required: true,
+        }),
+    };
+    static summary = 'Get investigation analytics';
+    async run() {
+        // Normalize dates to ISO 8601 datetime format
+        const startTime = this.normalizeDateTime(this.flags.start);
+        const endTime = this.normalizeDateTime(this.flags.end);
+        const body = {
+            endTime,
+            interval: this.flags.interval,
+            startTime,
+        };
+        if (this.flags['group-by'])
+            body.groupBy = this.flags['group-by'];
+        const result = await this.api('theopolis', 'investigations/analytics', { body });
+        if (!this.jsonEnabled()) {
+            const data = result.data ?? [];
+            this.log(`\nInvestigation Analytics (${this.env}):\n`);
+            this.log(`  Time range: ${this.flags.start} → ${this.flags.end}`);
+            this.log(`  Interval: ${this.flags.interval}\n`);
+            if (data.length > 0) {
+                // Derive columns from data keys
+                const keys = Object.keys(data[0]);
+                const columns = keys.map((key) => ({
+                    key,
+                    label: key.toUpperCase(),
+                    width: Math.max(key.length + 2, 16),
+                }));
+                this.log(formatTable(data, columns));
+            }
+            else {
+                this.log('  No analytics data for this time range.');
+            }
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/commands/investigations/analytics.js.map

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

package/dist/commands/investigations/get.d.ts

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

package/dist/commands/investigations/get.js

@@ -0,0 +1,38 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatDetail } from '../../lib/formatters.js';
+export default class InvestigationsGet extends BaseCommand {
+    static args = {
+        id: Args.string({ description: 'Investigation (taskflow) ID', required: true }),
+    };
+    static description = 'Get detailed information about a specific investigation by ID.';
+    static examples = [
+        '<%= config.bin %> investigations get <id>',
+        '<%= config.bin %> investigations get <id> --json',
+    ];
+    static summary = 'Get an investigation by ID';
+    async run() {
+        // List all and filter — theopolis doesn't have a direct GET by ID for taskflows
+        const result = await this.api('theopolis', 'taskflows', { method: 'GET' });
+        const investigation = (result.items ?? []).find((i) => i.id === this.args.id);
+        if (!investigation) {
+            this.error(`Investigation not found: ${this.args.id}`);
+        }
+        if (!this.jsonEnabled()) {
+            this.log(`\nInvestigation Details (${this.env}):\n`);
+            this.log(formatDetail(investigation, {
+                createdAt: 'Created',
+                description: 'Description',
+                graph: 'Graph',
+                id: 'ID',
+                isSignalHandler: 'Signal Handler',
+                name: 'Name',
+                tags: 'Tags',
+                updatedAt: 'Updated',
+            }));
+            this.log('');
+        }
+        return investigation;
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/investigations/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/investigations/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAEpD,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,WAAqC;IAClF,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,6BAA6B,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KAC9E,CAAA;IAED,MAAM,CAAU,WAAW,GAAG,gEAAgE,CAAA;IAE9F,MAAM,CAAU,QAAQ,GAAG;QACzB,2CAA2C;QAC3C,kDAAkD;KACnD,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,4BAA4B,CAAA;IAE/C,KAAK,CAAC,GAAG;QACd,gFAAgF;QAChF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,WAAW,EACX,WAAW,EACX,EAAC,MAAM,EAAE,KAAK,EAAC,CAChB,CAAA;QAED,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC7E,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;QACxD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YACpD,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,aAAa,EAAE;gBACnC,SAAS,EAAE,SAAS;gBACpB,WAAW,EAAE,aAAa;gBAC1B,KAAK,EAAE,OAAO;gBACd,EAAE,EAAE,IAAI;gBACR,eAAe,EAAE,gBAAgB;gBACjC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,SAAS;aACrB,CAAC,CAAC,CAAA;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,aAAa,CAAA;IACtB,CAAC"}

package/dist/commands/investigations/list.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command.js';
+export default class InvestigationsList extends BaseCommand<typeof InvestigationsList> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'signal-handler': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static summary: string;
+    run(): Promise<{
+        items: unknown[];
+    }>;
+}

package/dist/commands/investigations/list.js

@@ -0,0 +1,41 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class InvestigationsList extends BaseCommand {
+    static description = `List investigations (AI-powered analysis workflows) in your organization.
+
+Investigations are automated AI workflows that analyze signals, diagnose problems,
+and produce reports. Use --signal-handler to filter for investigations that are
+triggered automatically by signals.`;
+    static examples = [
+        '<%= config.bin %> investigations list',
+        '<%= config.bin %> investigations list --signal-handler',
+        '<%= config.bin %> investigations list --json',
+    ];
+    static flags = {
+        'signal-handler': Flags.boolean({
+            description: 'Only show investigations that handle signals',
+        }),
+    };
+    static summary = 'List investigations';
+    async run() {
+        const query = {};
+        if (this.flags['signal-handler']) {
+            query.isSignalHandler = 'true';
+        }
+        const result = await this.api('theopolis', 'taskflows', { method: 'GET', query });
+        if (!this.jsonEnabled()) {
+            const columns = [
+                { key: 'name', label: 'NAME', width: 35 },
+                { key: 'id', label: 'ID', width: 40 },
+                { key: 'isSignalHandler', label: 'SIGNAL HANDLER', width: 16 },
+                { key: 'description', label: 'DESCRIPTION', width: 40 },
+            ];
+            this.log(`\nInvestigations (${this.env} environment):\n`);
+            this.log(formatTable(result.items ?? [], columns));
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/investigations/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/investigations/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAA;AAEjC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAc,WAAW,EAAC,MAAM,yBAAyB,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,WAAsC;IACpF,MAAM,CAAU,WAAW,GAAG;;;;oCAII,CAAA;IAElC,MAAM,CAAU,QAAQ,GAAG;QACzB,uCAAuC;QACvC,wDAAwD;QACxD,8CAA8C;KAC/C,CAAA;IAED,MAAM,CAAU,KAAK,GAAG;QACtB,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC;YAC9B,WAAW,EAAE,8CAA8C;SAC5D,CAAC;KACH,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,qBAAqB,CAAA;IAExC,KAAK,CAAC,GAAG;QACd,MAAM,KAAK,GAA2B,EAAE,CAAA;QACxC,IAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,eAAe,GAAG,MAAM,CAAA;QAChC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,WAAW,EACX,WAAW,EACX,EAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAC,CACvB,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,GAAa;gBACxB,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAC;gBACvC,EAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAC;gBACnC,EAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,EAAE,EAAC;gBAC5D,EAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,EAAC;aACtD,CAAA;YAED,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAA;YACzD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;YAClD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC"}

package/dist/commands/investigations/run.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base-command.js';
+export default class InvestigationsRun extends BaseCommand<typeof InvestigationsRun> {
+    static args: {
+        investigationId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        runId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'log-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'trace-signal': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static summary: string;
+    run(): Promise<Record<string, unknown>>;
+}

package/dist/commands/investigations/run.js

@@ -0,0 +1,96 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatDetail } from '../../lib/formatters.js';
+export default class InvestigationsRun extends BaseCommand {
+    static args = {
+        investigationId: Args.string({ description: 'Investigation (taskflow) ID', required: true }),
+        runId: Args.string({ description: 'Run ID', required: true }),
+    };
+    static description = `Get detailed information about a specific investigation run.
+
+Shows run details including status, signal information, events, and the complete execution 
+log with node inputs/outputs, task messages, tool usage, and results.
+
+Use this to trace the investigation run back to its signal and triggering event.`;
+    static examples = [
+        '<%= config.bin %> investigations run <investigation-id> <run-id>',
+        '<%= config.bin %> investigations run <investigation-id> <run-id> --log-only',
+        '<%= config.bin %> investigations run <investigation-id> <run-id> --json',
+    ];
+    static flags = {
+        'log-only': Flags.boolean({
+            description: 'Only show the execution log (skip run details)',
+        }),
+        'trace-signal': Flags.boolean({
+            description: 'Fetch and display the signal and event information for this run',
+        }),
+    };
+    static summary = 'Get investigation run details and execution log';
+    async run() {
+        const { investigationId, runId } = this.args;
+        // Fetch both run details and execution log in parallel
+        const [runData, logData] = await Promise.all([
+            this.api('theopolis', `taskflows/${investigationId}/runs/${runId}`, { method: 'GET' }),
+            this.api('theopolis', `taskflows/${investigationId}/runs/${runId}/execution-log`, { method: 'GET' }),
+        ]);
+        const result = {
+            run: runData.run,
+            events: runData.events,
+            executionLog: logData.executionLog,
+        };
+        // If trace-signal is enabled and we have a signalId, fetch signal and event info
+        if (this.flags['trace-signal'] && runData.run.signalId) {
+            try {
+                const signal = await this.api('theopolis', `signals/${runData.run.signalId}`, { method: 'GET' });
+                result.signal = signal;
+                // If signal has an eventId, fetch the event
+                if (signal.eventId) {
+                    try {
+                        const event = await this.api('admin', `events/${signal.eventId}`, {
+                            method: 'GET',
+                        });
+                        result.triggerEvent = event;
+                    }
+                    catch {
+                        // Event might not exist or be accessible
+                    }
+                }
+            }
+            catch {
+                // Signal might not exist
+            }
+        }
+        if (!this.jsonEnabled()) {
+            if (!this.flags['log-only']) {
+                this.log(`\nInvestigation Run Details (${this.env}):\n`);
+                this.log(formatDetail(runData.run));
+                this.log('');
+                // Show signal trace if requested
+                if (this.flags['trace-signal'] && result.signal) {
+                    this.log(`Signal Details:\n`);
+                    this.log(formatDetail(result.signal));
+                    this.log('');
+                    if (result.triggerEvent) {
+                        this.log(`Triggering Event:\n`);
+                        this.log(formatDetail(result.triggerEvent));
+                        this.log('');
+                    }
+                }
+                if (runData.events && Array.isArray(runData.events) && runData.events.length > 0) {
+                    this.log(`Run Events (${runData.events.length}):\n`);
+                    for (const event of runData.events) {
+                        this.log(formatDetail(event));
+                        this.log('');
+                    }
+                }
+            }
+            this.log(`Execution Log:\n`);
+            this.log('─'.repeat(80));
+            this.log(logData.executionLog);
+            this.log('─'.repeat(80));
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/investigations/run.js.map

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

package/dist/commands/investigations/runs-list.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from '../../base-command.js';
+export default class InvestigationsRunsList extends BaseCommand<typeof InvestigationsRunsList> {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        details: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        offset: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static summary: string;
+    run(): Promise<{
+        runs: unknown[];
+        total: number;
+    }>;
+}

package/dist/commands/investigations/runs-list.js

@@ -0,0 +1,57 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class InvestigationsRunsList extends BaseCommand {
+    static args = {
+        id: Args.string({ description: 'Investigation (taskflow) ID', required: true }),
+    };
+    static description = `List actual investigation runs (not evaluation runs) for a specific investigation.
+
+Shows runs with their status, signal IDs, and timestamps. Use 'investigations run' to see
+detailed execution logs for a specific run.`;
+    static examples = [
+        '<%= config.bin %> investigations runs-list <id>',
+        '<%= config.bin %> investigations runs-list <id> --limit 50',
+        '<%= config.bin %> investigations runs-list <id> --details --json',
+    ];
+    static flags = {
+        details: Flags.boolean({
+            description: 'Include detailed information about each run',
+        }),
+        limit: Flags.integer({
+            char: 'l',
+            default: 20,
+            description: 'Maximum number of runs to return',
+        }),
+        offset: Flags.integer({
+            char: 'o',
+            default: 0,
+            description: 'Offset for pagination',
+        }),
+    };
+    static summary = 'List actual investigation runs';
+    async run() {
+        const query = {
+            limit: this.flags.limit.toString(),
+            offset: this.flags.offset.toString(),
+        };
+        if (this.flags.details) {
+            query.details = 'true';
+        }
+        const result = await this.api('theopolis', `taskflows/${this.args.id}/runs/paginated`, { method: 'GET', query });
+        if (!this.jsonEnabled()) {
+            const columns = [
+                { key: 'id', label: 'RUN ID', width: 40 },
+                { key: 'signalId', label: 'SIGNAL ID', width: 40 },
+                { key: 'status', label: 'STATUS', width: 14 },
+                { key: 'createdAt', label: 'CREATED', width: 26 },
+            ];
+            this.log(`\nInvestigation Runs (${this.env}):\n`);
+            this.log(`  Total: ${result.total}  Showing: ${result.runs.length}  Offset: ${this.flags.offset}\n`);
+            this.log(formatTable(result.runs ?? [], columns));
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=runs-list.js.map

package/dist/commands/investigations/runs-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs-list.js","sourceRoot":"","sources":["../../../src/commands/investigations/runs-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAc,WAAW,EAAC,MAAM,yBAAyB,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,sBAAuB,SAAQ,WAA0C;IAC5F,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,6BAA6B,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KAC9E,CAAA;IAED,MAAM,CAAU,WAAW,GAAG;;;4CAGY,CAAA;IAE1C,MAAM,CAAU,QAAQ,GAAG;QACzB,iDAAiD;QACjD,4DAA4D;QAC5D,kEAAkE;KACnE,CAAA;IAED,MAAM,CAAU,KAAK,GAAG;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;YACrB,WAAW,EAAE,6CAA6C;SAC3D,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,kCAAkC;SAChD,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;YACpB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,uBAAuB;SACrC,CAAC;KACH,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,gCAAgC,CAAA;IAEnD,KAAK,CAAC,GAAG;QACd,MAAM,KAAK,GAA2B;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE;YAClC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE;SACrC,CAAA;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACvB,KAAK,CAAC,OAAO,GAAG,MAAM,CAAA;QACxB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,WAAW,EACX,aAAa,IAAI,CAAC,IAAI,CAAC,EAAE,iBAAiB,EAC1C,EAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAC,CACvB,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,GAAa;gBACxB,EAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAC;gBACvC,EAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAC;gBAChD,EAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAC;gBAC3C,EAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAC;aAChD,CAAA;YAED,IAAI,CAAC,GAAG,CAAC,yBAAyB,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YACjD,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,KAAK,cAAc,MAAM,CAAC,IAAI,CAAC,MAAM,aAAa,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAA;YACpG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;YACjD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC"}

package/dist/commands/investigations/runs.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command.js';
+export default class InvestigationsRuns extends BaseCommand<typeof InvestigationsRuns> {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static summary: string;
+    run(): Promise<{
+        runs: unknown[];
+    }>;
+}

package/dist/commands/investigations/runs.js

@@ -0,0 +1,30 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class InvestigationsRuns extends BaseCommand {
+    static args = {
+        id: Args.string({ description: 'Investigation (taskflow) ID', required: true }),
+    };
+    static description = 'List evaluation runs for a specific investigation.';
+    static examples = [
+        '<%= config.bin %> investigations runs <id>',
+        '<%= config.bin %> investigations runs <id> --json',
+    ];
+    static summary = 'List runs for an investigation';
+    async run() {
+        const result = await this.api('theopolis', `taskflows/${this.args.id}/eval/runs`, { method: 'GET' });
+        if (!this.jsonEnabled()) {
+            const columns = [
+                { key: 'id', label: 'RUN ID', width: 40 },
+                { key: 'status', label: 'STATUS', width: 14 },
+                { key: 'createdAt', label: 'CREATED', width: 26 },
+                { key: 'taskFlowVersionId', label: 'VERSION ID', width: 40 },
+            ];
+            this.log(`\nInvestigation Runs (${this.env}):\n`);
+            this.log(formatTable(result.runs ?? [], columns));
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=runs.js.map

package/dist/commands/investigations/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../../src/commands/investigations/runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAc,WAAW,EAAC,MAAM,yBAAyB,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,WAAsC;IACpF,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,6BAA6B,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KAC9E,CAAA;IAED,MAAM,CAAU,WAAW,GAAG,oDAAoD,CAAA;IAElF,MAAM,CAAU,QAAQ,GAAG;QACzB,4CAA4C;QAC5C,mDAAmD;KACpD,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,gCAAgC,CAAA;IAEnD,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,WAAW,EACX,aAAa,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,EACrC,EAAC,MAAM,EAAE,KAAK,EAAC,CAChB,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,GAAa;gBACxB,EAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAC;gBACvC,EAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAC;gBAC3C,EAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAC;gBAC/C,EAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAC;aAC3D,CAAA;YAED,IAAI,CAAC,GAAG,CAAC,yBAAyB,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YACjD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;YACjD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC"}

package/dist/commands/investigations/stats.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../base-command.js';
+export default class InvestigationsStats extends BaseCommand<typeof InvestigationsStats> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        end: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        start: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static summary: string;
+    run(): Promise<Record<string, unknown>>;
+}

package/dist/commands/investigations/stats.js

@@ -0,0 +1,40 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatDetail } from '../../lib/formatters.js';
+export default class InvestigationsStats extends BaseCommand {
+    static description = 'Get investigation statistics for a time range.';
+    static examples = [
+        '<%= config.bin %> investigations stats --start 2026-01-01 --end 2026-02-01',
+        '<%= config.bin %> investigations stats --start 2026-01-01 --end 2026-02-01 --json',
+    ];
+    static flags = {
+        end: Flags.string({
+            description: 'End time (ISO 8601)',
+            required: true,
+        }),
+        start: Flags.string({
+            description: 'Start time (ISO 8601)',
+            required: true,
+        }),
+    };
+    static summary = 'Get investigation stats';
+    async run() {
+        // Normalize dates to ISO 8601 datetime format
+        const startTime = this.normalizeDateTime(this.flags.start);
+        const endTime = this.normalizeDateTime(this.flags.end);
+        const result = await this.api('theopolis', 'investigations/stats', {
+            body: {
+                endTime,
+                startTime,
+            },
+        });
+        if (!this.jsonEnabled()) {
+            this.log(`\nInvestigation Stats (${this.env}):\n`);
+            this.log(`  Time range: ${this.flags.start} → ${this.flags.end}\n`);
+            this.log(formatDetail(result));
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=stats.js.map

package/dist/commands/investigations/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/commands/investigations/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAA;AAEjC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAEpD,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,WAAuC;IACtF,MAAM,CAAU,WAAW,GAAG,gDAAgD,CAAA;IAE9E,MAAM,CAAU,QAAQ,GAAG;QACzB,4EAA4E;QAC5E,mFAAmF;KACpF,CAAA;IAED,MAAM,CAAU,KAAK,GAAG;QACtB,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,qBAAqB;YAClC,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAClB,WAAW,EAAE,uBAAuB;YACpC,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,yBAAyB,CAAA;IAE5C,KAAK,CAAC,GAAG;QACd,8CAA8C;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAEtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,WAAW,EACX,sBAAsB,EACtB;YACE,IAAI,EAAE;gBACJ,OAAO;gBACP,SAAS;aACV;SACF,CACF,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,0BAA0B,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YAClD,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;YACnE,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAA;YAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC"}

package/dist/commands/investigations/trigger.d.ts

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

package/dist/commands/investigations/trigger.js

@@ -0,0 +1,43 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class InvestigationsTrigger extends BaseCommand {
+    static args = {
+        id: Args.string({ description: 'Investigation (taskflow) ID', required: true }),
+    };
+    static description = `Trigger an investigation to run. Provide input text describing the problem
+or context for the investigation. The investigation runs asynchronously and
+returns a run ID you can use to check results.`;
+    static examples = [
+        '<%= config.bin %> investigations trigger <id> --input "Robot stopped responding"',
+        '<%= config.bin %> investigations trigger <id> --input "Battery draining fast on device X" --json',
+    ];
+    static flags = {
+        input: Flags.string({
+            char: 'i',
+            description: 'Input text / problem description for the investigation',
+            required: true,
+        }),
+        'signal-id': Flags.string({
+            description: 'Optional signal ID to associate with this run',
+        }),
+    };
+    static summary = 'Trigger an investigation';
+    async run() {
+        const body = {
+            input: this.flags.input,
+        };
+        if (this.flags['signal-id']) {
+            body.signalId = this.flags['signal-id'];
+        }
+        const result = await this.api('theopolis', `taskflows/${this.args.id}/trigger`, { body });
+        if (!this.jsonEnabled()) {
+            this.log(`\nInvestigation triggered successfully (${this.env}).`);
+            this.log(`  Run ID: ${result.taskFlowRunId ?? result.id ?? '—'}`);
+            if (result.signalId)
+                this.log(`  Signal ID: ${result.signalId}`);
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=trigger.js.map

package/dist/commands/investigations/trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.js","sourceRoot":"","sources":["../../../src/commands/investigations/trigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AAEjD,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,WAAyC;IAC1F,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,6BAA6B,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KAC9E,CAAA;IAED,MAAM,CAAU,WAAW,GAAG;;+CAEe,CAAA;IAE7C,MAAM,CAAU,QAAQ,GAAG;QACzB,kFAAkF;QAClF,kGAAkG;KACnG,CAAA;IAED,MAAM,CAAU,KAAK,GAAG;QACtB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,wDAAwD;YACrE,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;YACxB,WAAW,EAAE,+CAA+C;SAC7D,CAAC;KACH,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,0BAA0B,CAAA;IAE7C,KAAK,CAAC,GAAG;QACd,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;SACxB,CAAA;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACzC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,WAAW,EACX,aAAa,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EACnC,EAAC,IAAI,EAAC,CACP,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,2CAA2C,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;YACjE,IAAI,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;YACjE,IAAI,MAAM,CAAC,QAAQ;gBAAE,IAAI,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;YAChE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC"}