@formant/formant-cli 0.1.0

package/dist/commands/signals/get.js

@@ -0,0 +1,80 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatDetail } from '../../lib/formatters.js';
+export default class SignalsGet extends BaseCommand {
+    static args = {
+        id: Args.string({ description: 'Signal ID (UUID)', required: true }),
+    };
+    static description = `Get detailed information about a specific signal by its ID.
+
+Shows signal details including the triggering event, goal, status, and type (manual, 
+eventTrigger, schedule, slack). Use --trace to also fetch the event and event trigger 
+information.`;
+    static examples = [
+        '<%= config.bin %> signals get <signal-id>',
+        '<%= config.bin %> signals get <signal-id> --trace',
+        '<%= config.bin %> signals get <signal-id> --json',
+    ];
+    static flags = {
+        trace: Flags.boolean({
+            description: 'Fetch and display the triggering event and event trigger information',
+        }),
+    };
+    static summary = 'Get a signal by ID';
+    async run() {
+        const signal = await this.api('theopolis', `signals/${this.args.id}`, {
+            method: 'GET',
+        });
+        const result = { signal };
+        // If trace is enabled, fetch event and event trigger
+        if (this.flags.trace) {
+            // Fetch event if available
+            if (signal.eventId) {
+                try {
+                    const event = await this.api('admin', `events/${signal.eventId}`, {
+                        method: 'GET',
+                    });
+                    result.event = event;
+                }
+                catch {
+                    // Event might not exist
+                }
+            }
+            // Fetch event trigger if available
+            if (signal.eventTriggerId) {
+                try {
+                    const eventTrigger = await this.api('admin', `event-triggers/${signal.eventTriggerId}`, { method: 'GET' });
+                    result.eventTrigger = eventTrigger;
+                }
+                catch {
+                    // Event trigger might not exist
+                }
+            }
+        }
+        if (!this.jsonEnabled()) {
+            this.log(`\nSignal Details (${this.env}):\n`);
+            this.log(formatDetail(signal));
+            this.log('');
+            if (this.flags.trace) {
+                if (result.event) {
+                    this.log(`Triggering Event:\n`);
+                    this.log(formatDetail(result.event));
+                    this.log('');
+                }
+                if (result.eventTrigger) {
+                    this.log(`Event Trigger Configuration:\n`);
+                    this.log(formatDetail(result.eventTrigger));
+                    this.log('');
+                }
+                if (signal.type === 'schedule' && signal.scheduleCron) {
+                    this.log(`Schedule: ${signal.scheduleCron}\n`);
+                }
+                if (signal.type === 'manual') {
+                    this.log(`Type: Manual (created by user)\n`);
+                }
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=get.js.map

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

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

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

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

package/dist/commands/signals/list.js

@@ -0,0 +1,30 @@
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class SignalsList extends BaseCommand {
+    static description = `List all signals in your organization.
+
+Signals are points of interest that trigger AI-powered investigations. They can be
+created manually, generated from device events, scheduled, or from Slack/Teams integrations.`;
+    static examples = [
+        '<%= config.bin %> signals list',
+        '<%= config.bin %> signals list --json',
+    ];
+    static summary = 'List all signals';
+    async run() {
+        const result = await this.api('theopolis', 'signals', { method: 'GET' });
+        if (!this.jsonEnabled()) {
+            const columns = [
+                { key: 'id', label: 'ID', width: 40 },
+                { key: 'type', label: 'TYPE', width: 16 },
+                { key: 'status', label: 'STATUS', width: 12 },
+                { key: 'goal', label: 'GOAL', width: 40 },
+                { key: 'createdAt', label: 'CREATED', width: 26 },
+            ];
+            this.log(`\nSignals (${this.env} environment):\n`);
+            this.log(formatTable(result.items ?? [], columns));
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/signals/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,WAAY,SAAQ,WAA+B;IACtE,MAAM,CAAU,WAAW,GAAG;;;6FAG6D,CAAA;IAE3F,MAAM,CAAU,QAAQ,GAAG;QACzB,gCAAgC;QAChC,uCAAuC;KACxC,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,kBAAkB,CAAA;IAErC,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,WAAW,EACX,SAAS,EACT,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,IAAI,EAAE,KAAK,EAAE,EAAE,EAAC;gBACnC,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAC;gBACvC,EAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAC;gBAC3C,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAC;gBACvC,EAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAC;aAChD,CAAA;YAED,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAA;YAClD,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/signals/query.d.ts

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

package/dist/commands/signals/query.js

@@ -0,0 +1,52 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class SignalsQuery extends BaseCommand {
+    static description = `Query signals by time range and type.
+
+Signal types: manual, eventTrigger, schedule, slack.`;
+    static examples = [
+        '<%= config.bin %> signals query --start 2026-01-01',
+        '<%= config.bin %> signals query --start 2026-01-01 --end 2026-02-01 --type eventTrigger',
+        '<%= config.bin %> signals query --start 2026-01-01 --json',
+    ];
+    static flags = {
+        end: Flags.string({
+            description: 'End time (ISO 8601)',
+        }),
+        start: Flags.string({
+            description: 'Start time (ISO 8601)',
+            required: true,
+        }),
+        type: Flags.string({
+            description: 'Filter by signal type',
+            options: ['manual', 'eventTrigger', 'schedule', 'slack'],
+        }),
+    };
+    static summary = 'Query signals by time range';
+    async run() {
+        // Normalize dates to ISO 8601 datetime format
+        const body = {
+            startTime: this.normalizeDateTime(this.flags.start),
+        };
+        if (this.flags.end)
+            body.endTime = this.normalizeDateTime(this.flags.end);
+        if (this.flags.type)
+            body.type = this.flags.type;
+        const result = await this.api('theopolis', 'signals/query', { body });
+        if (!this.jsonEnabled()) {
+            const columns = [
+                { key: 'id', label: 'ID', width: 40 },
+                { key: 'type', label: 'TYPE', width: 16 },
+                { key: 'status', label: 'STATUS', width: 12 },
+                { key: 'goal', label: 'GOAL', width: 40 },
+                { key: 'createdAt', label: 'CREATED', width: 26 },
+            ];
+            this.log(`\nSignals (${this.env} environment):\n`);
+            this.log(formatTable(result.items ?? [], columns));
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/commands/signals/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/commands/signals/query.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,YAAa,SAAQ,WAAgC;IACxE,MAAM,CAAU,WAAW,GAAG;;qDAEqB,CAAA;IAEnD,MAAM,CAAU,QAAQ,GAAG;QACzB,oDAAoD;QACpD,yFAAyF;QACzF,2DAA2D;KAC5D,CAAA;IAED,MAAM,CAAU,KAAK,GAAG;QACtB,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,qBAAqB;SACnC,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAClB,WAAW,EAAE,uBAAuB;YACpC,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,uBAAuB;YACpC,OAAO,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,CAAC;SACzD,CAAC;KACH,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,6BAA6B,CAAA;IAEhD,KAAK,CAAC,GAAG;QACd,8CAA8C;QAC9C,MAAM,IAAI,GAA4B;YACpC,SAAS,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;SACpD,CAAA;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACzE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,WAAW,EACX,eAAe,EACf,EAAC,IAAI,EAAC,CACP,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,GAAa;gBACxB,EAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAC;gBACnC,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAC;gBACvC,EAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAC;gBAC3C,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAC;gBACvC,EAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAC;aAChD,CAAA;YAED,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAA;YAClD,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/users/get.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base-command.js';
+export default class UsersGet extends BaseCommand<typeof UsersGet> {
+    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/users/get.js

@@ -0,0 +1,28 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatDetail } from '../../lib/formatters.js';
+export default class UsersGet extends BaseCommand {
+    static args = {
+        id: Args.string({ description: 'User ID (UUID)', required: true }),
+    };
+    static description = `Get detailed information about a user.
+
+Shows user details including email, name, roles, and account settings.`;
+    static examples = [
+        '<%= config.bin %> users get <user-id>',
+        '<%= config.bin %> users get <user-id> --json',
+    ];
+    static summary = 'Get user details';
+    async run() {
+        const user = await this.api('admin', `users/${this.args.id}`, {
+            method: 'GET',
+        });
+        if (!this.jsonEnabled()) {
+            this.log(`\nUser Details (${this.env}):\n`);
+            this.log(formatDetail(user));
+            this.log('');
+        }
+        return user;
+    }
+}
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/users/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,QAAS,SAAQ,WAA4B;IAChE,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KACjE,CAAA;IAED,MAAM,CAAU,WAAW,GAAG;;uEAEuC,CAAA;IAErE,MAAM,CAAU,QAAQ,GAAG;QACzB,uCAAuC;QACvC,8CAA8C;KAC/C,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,kBAAkB,CAAA;IAErC,KAAK,CAAC,GAAG;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAA0B,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE;YACrF,MAAM,EAAE,KAAK;SACd,CAAC,CAAA;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,mBAAmB,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YAC3C,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;YAC5B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC"}

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

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

package/dist/commands/users/list.js

@@ -0,0 +1,28 @@
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class UsersList extends BaseCommand {
+    static description = `List all users in your organization.
+
+Shows user accounts, their email addresses, and account status.`;
+    static examples = [
+        '<%= config.bin %> users list',
+        '<%= config.bin %> users list --json',
+    ];
+    static summary = 'List users';
+    async run() {
+        const result = await this.api('admin', 'users', { method: 'GET' });
+        if (!this.jsonEnabled()) {
+            const columns = [
+                { key: 'email', label: 'EMAIL', width: 40 },
+                { key: 'name', label: 'NAME', width: 30 },
+                { key: 'id', label: 'ID', width: 40 },
+                { key: 'enabled', label: 'ENABLED', width: 8 },
+            ];
+            this.log(`\nUsers (${this.env}):\n`);
+            this.log(formatTable(result.items ?? [], columns));
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/users/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,SAAU,SAAQ,WAA6B;IAClE,MAAM,CAAU,WAAW,GAAG;;gEAEgC,CAAA;IAE9D,MAAM,CAAU,QAAQ,GAAG;QACzB,8BAA8B;QAC9B,qCAAqC;KACtC,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,YAAY,CAAA;IAE/B,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,OAAO,EACP,OAAO,EACP,EAAC,MAAM,EAAE,KAAK,EAAC,CAChB,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,GAAa;gBACxB,EAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAC;gBACzC,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,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAC;aAC7C,CAAA;YAED,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YACpC,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/help.d.ts

@@ -0,0 +1,4 @@
+import { Help } from '@oclif/core';
+export default class FcliHelp extends Help {
+    protected showRootHelp(): Promise<void>;
+}

package/dist/help.js

@@ -0,0 +1,91 @@
+import { Help } from '@oclif/core';
+export default class FcliHelp extends Help {
+    async showRootHelp() {
+        const output = `
+   ███████╗ ██████╗██╗     ██╗
+   ██╔════╝██╔════╝██║     ██║     🤖 Formant CLI v${this.config.version}
+   █████╗  ██║     ██║     ██║     ⚡ Manage your robot fleet
+   ██╔══╝  ██║     ██║     ██║     🚀 from the command line
+   ██║     ╚██████╗███████╗██║
+   ╚═╝      ╚═════╝╚══════╝╚═╝
+
+USAGE
+  $ fcli <command> [flags]
+
+CONCEPTS
+  Device         A robot or sensor in your fleet
+  Event          Important occurrence emitted by a device
+  Signal         Point of interest from an event, schedule, or manual trigger
+  Investigation  AI-powered analysis workflow triggered by a signal
+  Query          Retrieve telemetry and sensor data from devices
+
+COMMANDS
+  devices          List and inspect robots/sensors in your fleet
+  events           View important events emitted by devices
+  query            Retrieve telemetry data (battery, temperature, etc.)
+  signals          Manage signals (points of interest that trigger analysis)
+  investigations   Run and monitor AI-powered analysis workflows
+  commands         Manage command templates and send commands to devices
+  event-triggers   Manage event trigger rules
+  users            Manage users in your organization
+  schedules        Manage scheduled tasks
+  fleets           Manage device groups
+  analytics        Execute SQL queries against analytics data
+  kv               Manage key-value store
+  help             Display help for fcli
+
+GLOBAL FLAGS
+  --dev            Target the dev environment
+  --stage          Target the stage environment
+  --json           Format output as JSON
+  -h, --help       Show help for a command
+
+AUTHENTICATION
+  Set these environment variables (or use a .env file):
+    FORMANT_USER       Service account email
+    FORMANT_PASSWORD   Service account password
+
+EXAMPLES
+  # List online robots and sensors
+  $ fcli devices list --dev
+  $ fcli devices list --tag location=warehouse --online
+  $ fcli devices config <device-id> --dev
+
+  # View critical events from a device
+  $ fcli events list --device <id> --severity critical --limit 20
+  $ fcli events get <event-id> --dev
+
+  # Query battery telemetry over time
+  $ fcli query --device <id> --stream battery_level --start 2026-01-01 --end 2026-01-02
+
+  # Trace investigation runs back to their origin
+  $ fcli investigations runs-list <investigation-id> --dev
+  $ fcli investigations run <investigation-id> <run-id> --trace-signal --dev
+  $ fcli signals get <signal-id> --trace --dev
+
+  # View signals and investigations
+  $ fcli signals query --start 2026-01-01 --end 2026-02-01
+  $ fcli investigations list
+  $ fcli investigations stats --start 2026-01-01 --end 2026-02-10
+
+  # Send commands to devices
+  $ fcli commands list --dev
+  $ fcli commands for-device <device-id> --dev
+  $ fcli commands send <device-id> <template-id> --param speed=5 --dev
+
+  # Manage event triggers and schedules
+  $ fcli event-triggers list --dev
+  $ fcli schedules list --dev
+
+  # Query analytics and latest values
+  $ fcli analytics query --sql "SELECT * FROM events LIMIT 10" --dev
+  $ fcli query latest-values --device <id> --stream battery_level --dev
+
+LEARN MORE
+  Use 'fcli <command> --help' for detailed help on any command.
+  Use 'fcli <command> <subcommand> --help' for subcommand details.
+`;
+        this.log(output);
+    }
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,IAAI;IACrB,KAAK,CAAC,YAAY;QACnC,MAAM,MAAM,GAAG;;qDAEkC,IAAI,CAAC,MAAM,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFvE,CAAA;QAEG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,CAAC;CACF"}

package/dist/hooks/init.d.ts

@@ -0,0 +1,3 @@
+import { Hook } from '@oclif/core';
+declare const hook: Hook.Init;
+export default hook;

package/dist/hooks/init.js

@@ -0,0 +1,7 @@
+import { config } from 'dotenv';
+const hook = async function () {
+    // Load .env from current working directory (optional — env vars take precedence)
+    config();
+};
+export default hook;
+//# sourceMappingURL=init.js.map

package/dist/hooks/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/hooks/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAA;AAE7B,MAAM,IAAI,GAAc,KAAK;IAC3B,iFAAiF;IACjF,MAAM,EAAE,CAAA;AACV,CAAC,CAAA;AAED,eAAe,IAAI,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { BaseCommand } from './base-command.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { BaseCommand } from './base-command.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAA"}

package/dist/lib/api.d.ts

@@ -0,0 +1,12 @@
+import { type Environment } from './config.js';
+export type ApiTarget = 'admin' | 'query' | 'theopolis';
+interface RequestOptions {
+    body?: unknown;
+    method?: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
+    query?: Record<string, string>;
+}
+/**
+ * Make an authenticated API request to a Formant service.
+ */
+export declare function apiRequest<T = unknown>(env: Environment, target: ApiTarget, path: string, options?: RequestOptions): Promise<T>;
+export {};

package/dist/lib/api.js

@@ -0,0 +1,46 @@
+import { getUrls } from './config.js';
+import { login } from './auth.js';
+function buildBaseUrl(env, target) {
+    const urls = getUrls(env);
+    switch (target) {
+        case 'admin': {
+            return `${urls.adminApi}/v1/admin`;
+        }
+        case 'query': {
+            return `${urls.queryApi}/v1/queries`;
+        }
+        case 'theopolis': {
+            return `${urls.theopolis}/api`;
+        }
+    }
+}
+/**
+ * Make an authenticated API request to a Formant service.
+ */
+export async function apiRequest(env, target, path, options = {}) {
+    const { body, method = body ? 'POST' : 'GET', query } = options;
+    const auth = await login(env);
+    let url = `${buildBaseUrl(env, target)}/${path}`;
+    if (query) {
+        const params = new URLSearchParams(query);
+        url += `?${params.toString()}`;
+    }
+    const headers = {
+        Authorization: `Bearer ${auth.accessToken}`,
+        'Content-Type': 'application/json',
+    };
+    const res = await fetch(url, {
+        body: body ? JSON.stringify(body) : undefined,
+        headers,
+        method,
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`API error ${res.status} ${method} ${url}: ${text}`);
+    }
+    // Handle 204 No Content
+    if (res.status === 204)
+        return undefined;
+    return (await res.json());
+}
+//# sourceMappingURL=api.js.map

package/dist/lib/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,OAAO,EAAC,MAAM,aAAa,CAAA;AACrD,OAAO,EAAC,KAAK,EAAC,MAAM,WAAW,CAAA;AAU/B,SAAS,YAAY,CAAC,GAAgB,EAAE,MAAiB;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACzB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,QAAQ,WAAW,CAAA;QACpC,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,QAAQ,aAAa,CAAA;QACtC,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,OAAO,GAAG,IAAI,CAAC,SAAS,MAAM,CAAA;QAChC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAgB,EAChB,MAAiB,EACjB,IAAY,EACZ,UAA0B,EAAE;IAE5B,MAAM,EAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAC,GAAG,OAAO,CAAA;IAC7D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAE7B,IAAI,GAAG,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAA;IAChD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAA;QACzC,GAAG,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAA;IAChC,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;QAC3C,cAAc,EAAE,kBAAkB;KACnC,CAAA;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7C,OAAO;QACP,MAAM;KACP,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,MAAM,IAAI,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC,CAAA;IACtE,CAAC;IAED,wBAAwB;IACxB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAc,CAAA;IAE7C,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAA;AAChC,CAAC"}

package/dist/lib/auth.d.ts

@@ -0,0 +1,17 @@
+import { type Environment } from './config.js';
+export interface AuthResult {
+    accessToken: string;
+    refreshToken?: string;
+    organizationId: string;
+    userId: string;
+}
+/**
+ * Authenticate with Formant using service account credentials.
+ * Reads FORMANT_USER and FORMANT_PASSWORD from environment.
+ * Caches tokens per environment for the lifetime of the CLI process.
+ */
+export declare function login(env: Environment): Promise<AuthResult>;
+/**
+ * Clear cached tokens (useful if a token expires mid-session).
+ */
+export declare function clearTokenCache(): void;

package/dist/lib/auth.js

@@ -0,0 +1,41 @@
+import { getUrls } from './config.js';
+// In-memory cache: one token per environment
+const tokenCache = new Map();
+/**
+ * Authenticate with Formant using service account credentials.
+ * Reads FORMANT_USER and FORMANT_PASSWORD from environment.
+ * Caches tokens per environment for the lifetime of the CLI process.
+ */
+export async function login(env) {
+    const cached = tokenCache.get(env);
+    if (cached)
+        return cached;
+    const email = process.env.FORMANT_USER;
+    const password = process.env.FORMANT_PASSWORD;
+    if (!email || !password) {
+        throw new Error('Missing credentials. Set FORMANT_USER and FORMANT_PASSWORD environment variables (or in a .env file).');
+    }
+    const urls = getUrls(env);
+    const res = await fetch(`${urls.adminApi}/v1/admin/auth/login`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ email, password }),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`Authentication failed (${res.status}): ${body}`);
+    }
+    const data = (await res.json());
+    if (!data.authentication?.accessToken) {
+        throw new Error('Authentication response missing access token. Check your credentials.');
+    }
+    tokenCache.set(env, data.authentication);
+    return data.authentication;
+}
+/**
+ * Clear cached tokens (useful if a token expires mid-session).
+ */
+export function clearTokenCache() {
+    tokenCache.clear();
+}
+//# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,OAAO,EAAC,MAAM,aAAa,CAAA;AASrD,6CAA6C;AAC7C,MAAM,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAA;AAErD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,GAAgB;IAC1C,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAA;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAA;IAE7C,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACzB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,sBAAsB,EAAE;QAC9D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAC,cAAc,EAAE,kBAAkB,EAAC;QAC7C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAC,KAAK,EAAE,QAAQ,EAAC,CAAC;KACxC,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAkC,CAAA;IAEhE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAA;IAC1F,CAAC;IAED,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;IACxC,OAAO,IAAI,CAAC,cAAc,CAAA;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,UAAU,CAAC,KAAK,EAAE,CAAA;AACpB,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,7 @@
+export type Environment = 'dev' | 'prod' | 'stage';
+export interface EnvUrls {
+    adminApi: string;
+    queryApi: string;
+    theopolis: string;
+}
+export declare function getUrls(env: Environment): EnvUrls;

package/dist/lib/config.js

@@ -0,0 +1,21 @@
+const ENVIRONMENTS = {
+    prod: {
+        adminApi: 'https://api.formant.io',
+        queryApi: 'https://api.formant.io',
+        theopolis: 'https://theopolis-prod-ad4d9de77f9a.herokuapp.com',
+    },
+    dev: {
+        adminApi: 'https://api-dev.formant.io',
+        queryApi: 'https://api-dev.formant.io',
+        theopolis: 'https://theopolis-dev-231bd5d86d0f.herokuapp.com',
+    },
+    stage: {
+        adminApi: 'https://api-stage.formant.io',
+        queryApi: 'https://api-stage.formant.io',
+        theopolis: 'https://theopolis-stage-80d087320b3d.herokuapp.com',
+    },
+};
+export function getUrls(env) {
+    return ENVIRONMENTS[env];
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAQA,MAAM,YAAY,GAAiC;IACjD,IAAI,EAAE;QACJ,QAAQ,EAAE,wBAAwB;QAClC,QAAQ,EAAE,wBAAwB;QAClC,SAAS,EAAE,mDAAmD;KAC/D;IACD,GAAG,EAAE;QACH,QAAQ,EAAE,4BAA4B;QACtC,QAAQ,EAAE,4BAA4B;QACtC,SAAS,EAAE,kDAAkD;KAC9D;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,8BAA8B;QACxC,QAAQ,EAAE,8BAA8B;QACxC,SAAS,EAAE,oDAAoD;KAChE;CACF,CAAA;AAED,MAAM,UAAU,OAAO,CAAC,GAAgB;IACtC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAA;AAC1B,CAAC"}

package/dist/lib/formatters.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Minimal table formatter — aligns columns with padding.
+ * No external dependencies.
+ */
+export interface Column {
+    key: string;
+    label: string;
+    width?: number;
+}
+/**
+ * Format an array of objects as an aligned table string.
+ */
+export declare function formatTable(rows: Record<string, unknown>[], columns: Column[]): string;
+/**
+ * Format a single object as a key-value detail view.
+ */
+export declare function formatDetail(obj: Record<string, unknown>, labels?: Record<string, string>): string;