@formant/formant-cli 0.3.0 → 0.4.2

package/dist/commands/signal/create.js

@@ -0,0 +1,95 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatDetail } from '../../lib/formatters.js';
+export default class SignalCreate extends BaseCommand {
+    static args = {
+        goal: Args.string({ description: 'Goal or description for the signal', required: true }),
+    };
+    static description = `Create a manual signal.
+
+Signals are points of interest that can trigger AI-powered investigations. Use this to
+manually create a signal with a goal description, optionally targeting a specific device
+or persona.`;
+    static examples = [
+        '<%= config.bin %> signal create "Robot arm jammed at joint 3"',
+        '<%= config.bin %> signal create "Battery draining fast" --device <device-id>',
+        '<%= config.bin %> signal create "Investigate sensor anomaly" --persona <persona-id>',
+        '<%= config.bin %> signal create "Test alarm scenario" --investigation <taskflow-id>',
+        '<%= config.bin %> signal create "Motor overheated" --investigation <id> --ground-truth "Should identify motor thermal fault"',
+    ];
+    static flags = {
+        device: Flags.string({
+            char: 'd',
+            description: 'Device ID to associate with this signal',
+        }),
+        'ground-truth': Flags.string({
+            char: 'g',
+            dependsOn: ['investigation'],
+            description: 'Expected outcome (ground truth) for this signal — requires --investigation',
+        }),
+        investigation: Flags.string({
+            char: 'i',
+            description: 'Investigation (taskflow) ID this signal targets',
+        }),
+        persona: Flags.string({
+            char: 'p',
+            description: 'Persona ID to handle this signal',
+        }),
+    };
+    static summary = 'Create a manual signal';
+    async run() {
+        const body = {
+            goal: this.args.goal,
+            type: 'manual',
+        };
+        if (this.flags.device)
+            body.deviceId = this.flags.device;
+        if (this.flags.persona)
+            body.personaId = this.flags.persona;
+        if (this.flags.investigation)
+            body.createdForTaskFlowId = this.flags.investigation;
+        const signal = await this.api('theopolis', 'signals', { body });
+        // If ground truth specified, create it for this signal + investigation
+        let groundTruth;
+        if (this.flags['ground-truth'] && this.flags.investigation) {
+            groundTruth = await this.api('theopolis', `taskflows/${this.flags.investigation}/eval/ground-truths`, {
+                body: {
+                    expectedOutcome: this.flags['ground-truth'],
+                    signalId: signal.id,
+                },
+            });
+        }
+        if (!this.jsonEnabled()) {
+            this.log(`\nSignal created (${this.env}):\n`);
+            const detail = {
+                createdAt: signal.createdAt,
+                deviceId: signal.deviceId ?? '—',
+                goal: signal.goal,
+                id: signal.id,
+                personaId: signal.personaId ?? '—',
+                status: signal.status,
+                type: signal.type,
+            };
+            const labels = {
+                createdAt: 'Created',
+                deviceId: 'Device',
+                goal: 'Goal',
+                id: 'ID',
+                personaId: 'Persona',
+                status: 'Status',
+                type: 'Type',
+            };
+            if (groundTruth) {
+                detail.groundTruth = groundTruth.expectedOutcome;
+                labels.groundTruth = 'Ground Truth';
+            }
+            this.log(formatDetail(detail, labels));
+            this.log('');
+        }
+        const result = { ...signal };
+        if (groundTruth)
+            result.groundTruth = groundTruth;
+        return result;
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/signal/create.js.map

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

package/dist/commands/{signals → signal}/get.js

@@ -11,9 +11,9 @@ Shows signal details including the triggering event, goal, status, and type (man
 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',
+        '<%= config.bin %> signal get <signal-id>',
+        '<%= config.bin %> signal get <signal-id> --trace',
+        '<%= config.bin %> signal get <signal-id> --json',
     ];
     static flags = {
         trace: Flags.boolean({

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

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

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

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

package/dist/commands/signal/list.js

@@ -0,0 +1,85 @@
+import { Flags } from '@oclif/core';
+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.
+
+Use --investigation to also show ground truth (expected outcome) for each signal
+that has one assigned for that investigation.`;
+    static examples = [
+        '<%= config.bin %> signal list',
+        '<%= config.bin %> signal list --investigation <taskflow-id>',
+        '<%= config.bin %> signal list --json',
+    ];
+    static flags = {
+        investigation: Flags.string({
+            char: 'i',
+            description: 'Investigation (taskflow) ID — shows ground truth for signals that have one',
+        }),
+    };
+    static summary = 'List all signals';
+    async run() {
+        const result = await this.api('theopolis', 'signals', { method: 'GET' });
+        // If investigation flag set, fetch ground truths and merge
+        let groundTruthMap;
+        if (this.flags.investigation) {
+            try {
+                const gtResult = await this.api('theopolis', `taskflows/${this.flags.investigation}/eval/ground-truths`, { method: 'GET' });
+                groundTruthMap = new Map();
+                for (const gt of gtResult.groundTruths ?? []) {
+                    groundTruthMap.set(gt.signalId, gt.expectedOutcome);
+                }
+                // Enrich signal items with ground truth
+                for (const signal of result.items ?? []) {
+                    const expectedOutcome = groundTruthMap.get(signal.id);
+                    if (expectedOutcome) {
+                        signal.expectedOutcome = expectedOutcome;
+                    }
+                }
+            }
+            catch {
+                // Investigation may not exist or have no ground truths — continue without
+            }
+        }
+        if (!this.jsonEnabled()) {
+            const hasGt = this.flags.investigation && groundTruthMap && groundTruthMap.size > 0;
+            const columns = [
+                { key: 'id', label: 'ID', width: 40 },
+                { key: 'type', label: 'TYPE', width: 14 },
+                { key: 'status', label: 'STATUS', width: 12 },
+                { key: 'goal', label: 'GOAL', width: 36 },
+                { key: 'createdAt', label: 'CREATED', width: 22 },
+            ];
+            if (hasGt) {
+                columns.push({ key: 'hasGroundTruth', label: 'GT', width: 4 });
+            }
+            // Mark signals that have ground truth
+            const items = (result.items ?? []).map((s) => ({
+                ...s,
+                hasGroundTruth: groundTruthMap?.has(s.id) ? '*' : '',
+            }));
+            this.log(`\nSignals (${this.env}):\n`);
+            this.log(formatTable(items, columns));
+            // Print full ground truths below the table
+            if (hasGt) {
+                this.log(`\nGround Truths:\n`);
+                for (const signal of result.items ?? []) {
+                    const gt = groundTruthMap.get(signal.id);
+                    if (gt) {
+                        const goal = String(signal.goal ?? '').slice(0, 60);
+                        this.log(`  ${signal.id}`);
+                        this.log(`    Goal:          ${goal}`);
+                        this.log(`    Ground Truth:  ${gt}`);
+                        this.log('');
+                    }
+                }
+            }
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

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

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

package/dist/commands/{signals → signal}/query.d.ts

@@ -4,6 +4,7 @@ export default class SignalsQuery extends BaseCommand<typeof SignalsQuery> {
     static examples: string[];
     static flags: {
         end: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        investigation: 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>;
     };

package/dist/commands/signal/query.js

@@ -0,0 +1,100 @@
+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.
+
+Use --investigation to also show ground truth (expected outcome) for each signal.`;
+    static examples = [
+        '<%= config.bin %> signal query --start 2026-01-01',
+        '<%= config.bin %> signal query --start 2026-01-01 --end 2026-02-01 --type eventTrigger',
+        '<%= config.bin %> signal query --start 2026-01-01 --investigation <taskflow-id>',
+        '<%= config.bin %> signal query --start 2026-01-01 --json',
+    ];
+    static flags = {
+        end: Flags.string({
+            description: 'End time (ISO 8601)',
+        }),
+        investigation: Flags.string({
+            char: 'i',
+            description: 'Investigation (taskflow) ID — shows ground truth for signals that have one',
+        }),
+        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 investigation flag set, fetch ground truths and merge
+        let groundTruthMap;
+        if (this.flags.investigation) {
+            try {
+                const gtResult = await this.api('theopolis', `taskflows/${this.flags.investigation}/eval/ground-truths`, { method: 'GET' });
+                groundTruthMap = new Map();
+                for (const gt of gtResult.groundTruths ?? []) {
+                    groundTruthMap.set(gt.signalId, gt.expectedOutcome);
+                }
+                for (const signal of result.items ?? []) {
+                    const expectedOutcome = groundTruthMap.get(signal.id);
+                    if (expectedOutcome) {
+                        signal.expectedOutcome = expectedOutcome;
+                    }
+                }
+            }
+            catch {
+                // Continue without ground truths
+            }
+        }
+        if (!this.jsonEnabled()) {
+            const hasGt = this.flags.investigation && groundTruthMap && groundTruthMap.size > 0;
+            const columns = [
+                { key: 'id', label: 'ID', width: 40 },
+                { key: 'type', label: 'TYPE', width: 14 },
+                { key: 'status', label: 'STATUS', width: 12 },
+                { key: 'goal', label: 'GOAL', width: 36 },
+                { key: 'createdAt', label: 'CREATED', width: 22 },
+            ];
+            if (hasGt) {
+                columns.push({ key: 'hasGroundTruth', label: 'GT', width: 4 });
+            }
+            const items = (result.items ?? []).map((s) => ({
+                ...s,
+                hasGroundTruth: groundTruthMap?.has(s.id) ? '*' : '',
+            }));
+            this.log(`\nSignals (${this.env}):\n`);
+            this.log(formatTable(items, columns));
+            if (hasGt) {
+                this.log(`\nGround Truths:\n`);
+                for (const signal of result.items ?? []) {
+                    const gt = groundTruthMap.get(signal.id);
+                    if (gt) {
+                        const goal = String(signal.goal ?? '').slice(0, 60);
+                        this.log(`  ${signal.id}`);
+                        this.log(`    Goal:          ${goal}`);
+                        this.log(`    Ground Truth:  ${gt}`);
+                        this.log('');
+                    }
+                }
+            }
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=query.js.map

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

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

package/dist/commands/signal/set-ground-truth.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command.js';
+export default class SignalSetGroundTruth extends BaseCommand<typeof SignalSetGroundTruth> {
+    static args: {
+        signalId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        investigationId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        expectedOutcome: 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/signal/set-ground-truth.js

@@ -0,0 +1,46 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatDetail } from '../../lib/formatters.js';
+export default class SignalSetGroundTruth extends BaseCommand {
+    static args = {
+        signalId: Args.string({ description: 'Signal ID (UUID)', required: true }),
+        investigationId: Args.string({ description: 'Investigation (taskflow) ID', required: true }),
+        expectedOutcome: Args.string({ description: 'The expected outcome / ground truth for this signal', required: true }),
+    };
+    static description = `Assign a ground truth (expected outcome) to a signal for an investigation.
+
+Ground truths define what the correct outcome should be when an investigation processes
+a given signal. They are used for evaluation and quality measurement of investigation
+workflows.`;
+    static examples = [
+        '<%= config.bin %> signal set-ground-truth <signal-id> <investigation-id> "The alarm should be dismissed as a false positive"',
+        '<%= config.bin %> signal set-ground-truth <signal-id> <investigation-id> "Root cause: overheated motor in joint 3" --json',
+    ];
+    static summary = 'Assign ground truth to a signal';
+    async run() {
+        const { expectedOutcome, investigationId, signalId } = this.args;
+        const groundTruth = await this.api('theopolis', `taskflows/${investigationId}/eval/ground-truths`, {
+            body: {
+                expectedOutcome,
+                signalId,
+            },
+        });
+        if (!this.jsonEnabled()) {
+            this.log(`\nGround truth assigned (${this.env}):\n`);
+            this.log(formatDetail({
+                expectedOutcome: groundTruth.expectedOutcome,
+                id: groundTruth.id,
+                investigation: investigationId,
+                signalId: groundTruth.signalId,
+            }, {
+                expectedOutcome: 'Expected Outcome',
+                id: 'Ground Truth ID',
+                investigation: 'Investigation',
+                signalId: 'Signal',
+            }));
+            this.log('');
+        }
+        return groundTruth;
+    }
+}
+//# sourceMappingURL=set-ground-truth.js.map

package/dist/commands/signal/set-ground-truth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-ground-truth.js","sourceRoot":"","sources":["../../../src/commands/signal/set-ground-truth.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,oBAAqB,SAAQ,WAAwC;IACxF,MAAM,CAAU,IAAI,GAAG;QACrB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;QACxE,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,6BAA6B,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;QAC1F,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,qDAAqD,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KACnH,CAAA;IAED,MAAM,CAAU,WAAW,GAAG;;;;WAIrB,CAAA;IAET,MAAM,CAAU,QAAQ,GAAG;QACzB,8HAA8H;QAC9H,2HAA2H;KAC5H,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,iCAAiC,CAAA;IAEpD,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,eAAe,EAAE,eAAe,EAAE,QAAQ,EAAC,GAAG,IAAI,CAAC,IAAI,CAAA;QAE9D,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,GAAG,CAChC,WAAW,EACX,aAAa,eAAe,qBAAqB,EACjD;YACE,IAAI,EAAE;gBACJ,eAAe;gBACf,QAAQ;aACT;SACF,CACF,CAAA;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,CACnB;gBACE,eAAe,EAAE,WAAW,CAAC,eAAe;gBAC5C,EAAE,EAAE,WAAW,CAAC,EAAE;gBAClB,aAAa,EAAE,eAAe;gBAC9B,QAAQ,EAAE,WAAW,CAAC,QAAQ;aAC/B,EACD;gBACE,eAAe,EAAE,kBAAkB;gBACnC,EAAE,EAAE,iBAAiB;gBACrB,aAAa,EAAE,eAAe;gBAC9B,QAAQ,EAAE,QAAQ;aACnB,CACF,CAAC,CAAA;YACF,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,WAAW,CAAA;IACpB,CAAC"}

package/dist/commands/{users → user}/get.js

@@ -9,8 +9,8 @@ export default class UsersGet extends BaseCommand {
 
 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',
+        '<%= config.bin %> user get <user-id>',
+        '<%= config.bin %> user get <user-id> --json',
     ];
     static summary = 'Get user details';
     async run() {

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/user/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,sCAAsC;QACtC,6CAA6C;KAC9C,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 → user}/list.js

@@ -5,8 +5,8 @@ export default class UsersList extends BaseCommand {
 
 Shows user accounts, their email addresses, and account status.`;
     static examples = [
-        '<%= config.bin %> users list',
-        '<%= config.bin %> users list --json',
+        '<%= config.bin %> user list',
+        '<%= config.bin %> user list --json',
     ];
     static summary = 'List users';
     async run() {

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/user/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,6BAA6B;QAC7B,oCAAoC;KACrC,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.js

@@ -3,17 +3,17 @@ export default class FcliHelp extends Help {
     async showRootHelp() {
         const output = `
    ███████╗ ██████╗██╗     ██╗
-   ██╔════╝██╔════╝██║     ██║     🤖 Formant CLI v${this.config.version}
-   █████╗  ██║     ██║     ██║     ⚡ Manage your robot fleet
-   ██╔══╝  ██║     ██║     ██║     🚀 from the command line
+   ██╔════╝██╔════╝██║     ██║     Formant CLI v${this.config.version}
+   █████╗  ██║     ██║     ██║     Manage your robot fleet
+   ██╔══╝  ██║     ██║     ██║     from the command line
    ██║     ╚██████╗███████╗██║
    ╚═╝      ╚═════╝╚══════╝╚═╝
 
 ABOUT
   Formant is a cloud platform for monitoring, operating, and analyzing robot fleets.
   This CLI lets you interact with your robots, query telemetry data, trigger AI-powered
-  investigations, manage users and permissions, and automate fleet operations — all from
-  your terminal.
+  investigations, delegate tasks to AI personas, and automate fleet operations — all
+  from your terminal.
 
 USAGE
   $ fcli <command> [flags]
@@ -24,23 +24,25 @@ KEY CONCEPTS
   Event          An important occurrence (alert, warning, error) emitted by a device
   Signal         A point of interest that triggers investigation or analysis
   Investigation  AI-powered workflow that analyzes device data and diagnoses issues
+  Persona        An AI agent with specific tools and instructions
   Stream         Real-time telemetry data (battery, temperature, location, sensors)
   Command        Remote instruction sent to a device to perform an action
   Fleet          A logical group of devices (by location, type, or tags)
 
 COMMANDS
   org              View and update your Formant organization
-  devices          Create, list, tag, and manage robots/sensors in your fleet
-  events           View and filter important events emitted by devices
+  device           Create, list, tag, and manage robots/sensors in your fleet
+  event            View and filter important events emitted by devices
   query            Retrieve historical telemetry data and latest sensor values
   ingest           Send telemetry data to devices via the Formant ingestion API
-  signals          List, query, and analyze signals that trigger investigations
-  investigations   Trigger, monitor, and analyze AI-powered diagnostic workflows
-  commands         Send remote commands to devices and view command history
-  event-triggers   Configure rules that automatically generate events and signals
-  users            List and inspect users in your organization
-  fleets           Manage device groups and organize your fleet
-  schedules        Set up recurring tasks and one-time scheduled jobs
+  signal           List, query, and analyze signals that trigger investigations
+  investigation    Trigger, monitor, and analyze AI-powered diagnostic workflows
+  persona          Manage AI personas and delegate async tasks
+  command          Send remote commands to devices and view command history
+  event-trigger    Configure rules that automatically generate events and signals
+  user             List and inspect users in your organization
+  fleet            Manage device groups and organize your fleet
+  schedule         Set up recurring tasks and one-time scheduled jobs
   analytics        Execute custom SQL queries against your analytics database
   kv               Store and retrieve metadata in the key-value store
   help             Display help for fcli
@@ -65,16 +67,16 @@ EXAMPLES
   $ fcli org update --name "Acme Robotics"              # Update org name
 
   # Device management
-  $ fcli devices list --online                          # List all online devices
-  $ fcli devices list --tag location=warehouse          # Filter by tags
-  $ fcli devices create --name "robot-001"              # Create a new device
-  $ fcli devices tag <device-id> --key env --value prod # Add tags
-  $ fcli devices rename <device-id> --name "robot-new"  # Rename a device
+  $ fcli device list --online                           # List all online devices
+  $ fcli device list --tag location=warehouse           # Filter by tags
+  $ fcli device create --name "robot-001"               # Create a new device
+  $ fcli device tag <device-id> --key env --value prod  # Add tags
+  $ fcli device rename <device-id> --name "robot-new"   # Rename a device
 
   # Telemetry queries
   $ fcli query --device <id> --stream battery_level --start 2026-01-01 --end 2026-01-02
   $ fcli query latest-values --device <id> --stream battery_level
-  $ fcli devices streams <device-id>                    # List available streams
+  $ fcli device streams <device-id>                     # List available streams
 
   # Ingest telemetry data
   $ fcli ingest numeric 42.5 --device <id> --stream battery_level
@@ -83,37 +85,41 @@ EXAMPLES
   $ fcli ingest batch --file payload.json               # Batch ingest from file
 
   # Events and monitoring
-  $ fcli events list --severity critical --limit 50     # View critical events
-  $ fcli events list --device <id> --start 2026-01-01  # Events for one device
-  $ fcli events get <event-id>                          # Get event details
+  $ fcli event list --severity critical --limit 50      # View critical events
+  $ fcli event list --device <id> --start 2026-01-01    # Events for one device
+  $ fcli event get <event-id>                           # Get event details
 
-  # AI investigations
-  $ fcli investigations list                            # List all investigations
-  $ fcli investigations trigger <inv-id> <device-id>    # Trigger an investigation
-  $ fcli investigations runs <inv-id>                   # View investigation runs
-  $ fcli investigations stats --start 2026-01-01        # Get investigation metrics
+  # AI personas
+  $ fcli persona list                                   # List all personas
+  $ fcli persona get <persona-id>                       # View persona tools
+  $ fcli persona delegate-task <persona-id> "Analyze recent failures"
+  $ fcli persona task-status <task-id>                  # Check task results
 
-  # Signals (investigation triggers)
-  $ fcli signals list --start 2026-01-01 --end 2026-02-01
-  $ fcli signals query --start 2026-01-01              # Query by time range
-  $ fcli signals count                                  # Count signals by type
-  $ fcli signals get <signal-id>                        # Get signal details
+  # AI investigations
+  $ fcli investigation list                             # List all investigations
+  $ fcli investigation trigger <id> -i "Robot stopped"  # Trigger an investigation
+  $ fcli investigation runs <id>                        # View investigation runs
+
+  # Signals and ground truths
+  $ fcli signal create "Motor overheated on device X"   # Create a manual signal
+  $ fcli signal create "Sensor fault" -i <inv-id> -g "Should detect thermal issue"
+  $ fcli signal list                                    # List all signals
+  $ fcli signal list --investigation <inv-id>           # List with ground truths
+  $ fcli signal query --start 2026-01-01                # Query by time range
+  $ fcli signal set-ground-truth <signal-id> <inv-id> "Expected outcome"
 
   # Remote commands
-  $ fcli commands list                                  # List command templates
-  $ fcli commands for-device <device-id>                # Commands for one device
-  $ fcli commands send <device-id> <template-id> --param speed=10
-  $ fcli commands history <device-id>                   # View command history
+  $ fcli command list                                   # List command templates
+  $ fcli command for-device <device-id>                 # Commands for one device
+  $ fcli command send <device-id> <template-id> --param speed=10
 
   # Event triggers (automation)
-  $ fcli event-triggers list                            # List all trigger rules
-  $ fcli event-triggers get <trigger-id>                # View trigger details
+  $ fcli event-trigger list                             # List all trigger rules
+  $ fcli event-trigger get <trigger-id>                 # View trigger details
 
   # User and fleet management
-  $ fcli users list                                     # List all users
-  $ fcli users get <user-id>                            # View user details
-  $ fcli fleets list                                    # List device groups
-  $ fcli fleets get <fleet-id>                          # View fleet details
+  $ fcli user list                                      # List all users
+  $ fcli fleet list                                     # List device groups
 
   # Analytics and data queries
   $ fcli analytics tables                               # List available tables
@@ -125,10 +131,10 @@ EXAMPLES
   $ fcli kv set <device-id> <key> <value>               # Store a value
 
 TIPS
-  • Use --json with any command to get machine-readable output for scripting
-  • Pipe output to jq for advanced JSON processing: fcli devices list --json | jq
-  • Set --dev or --stage to target non-production environments
-  • Use fcli <command> --help to see detailed help for any command
+  * Use --json with any command to get machine-readable output for scripting
+  * Pipe output to jq for advanced JSON processing: fcli device list --json | jq
+  * Set --dev or --stage to target non-production environments
+  * Use fcli <command> --help to see detailed help for any command
 
 LEARN MORE
   Documentation:  https://formant.io/docs

package/dist/help.js.map

@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmIvE,CAAA;QAEG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,CAAC;CACF"}
+{"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;;kDAE+B,IAAI,CAAC,MAAM,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyIpE,CAAA;QAEG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,CAAC;CACF"}

package/dist/lib/api.d.ts

@@ -1,5 +1,5 @@
 import { type Environment } from './config.js';
-export type ApiTarget = 'admin' | 'ingest' | 'query' | 'theopolis';
+export type ApiTarget = 'admin' | 'gateway' | 'ingest' | 'query' | 'theopolis';
 interface RequestOptions {
     body?: unknown;
     method?: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';