faces-cli 1.0.0 → 1.1.0

package/dist/commands/face/diff.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../base.js';
+export default class FaceDiff extends BaseCommand {
+    static description: string;
+    static flags: {
+        face: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/face/diff.js

@@ -0,0 +1,54 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class FaceDiff extends BaseCommand {
+    static description = 'Compare owned faces pairwise across all centroid components';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        face: Flags.string({
+            description: 'Face username to include (repeatable, min 2)',
+            multiple: true,
+            required: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(FaceDiff);
+        const client = this.makeClient(flags);
+        if (flags.face.length < 2) {
+            this.error('At least 2 --face values are required');
+        }
+        const params = { faces: flags.face.join(',') };
+        let data;
+        try {
+            data = await client.get('/v1/faces/diff', { params });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled()) {
+            const res = data;
+            const faces = res.faces;
+            const components = ['face', 'beta', 'delta', 'epsilon'];
+            for (let i = 0; i < faces.length; i++) {
+                for (let j = i + 1; j < faces.length; j++) {
+                    const a = faces[i];
+                    const b = faces[j];
+                    const scores = res.similarity[a][b];
+                    const parts = components.map(c => {
+                        const v = scores[c];
+                        return `${c}: ${v === null ? '—' : v.toFixed(2)}`;
+                    });
+                    this.log(`${a}  ↔  ${b}   ${parts.join('   ')}`);
+                }
+            }
+            this.log('');
+            const updated = Object.entries(res.centroids_updated_at)
+                .map(([face, ts]) => `${face} ${new Date(ts * 1000).toISOString().slice(0, 10)}`)
+                .join(', ');
+            this.log(`Centroids updated: ${updated}`);
+        }
+        return data;
+    }
+}

package/dist/commands/face/neighbors.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base.js';
+export default class FaceNeighbors extends BaseCommand {
+    static description: string;
+    static flags: {
+        k: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        component: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        direction: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static args: {
+        face_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/face/neighbors.js

@@ -0,0 +1,62 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class FaceNeighbors extends BaseCommand {
+    static description = 'Find the most similar or dissimilar owned faces to a given face';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        k: Flags.integer({
+            description: 'Number of results (1–20)',
+            default: 5,
+            min: 1,
+            max: 20,
+        }),
+        component: Flags.string({
+            description: 'Centroid component to rank on (beta, delta, epsilon are the principal components of a face; face is their composite)',
+            options: ['face', 'beta', 'delta', 'epsilon'],
+            default: 'face',
+        }),
+        direction: Flags.string({
+            description: 'nearest (most similar) or furthest (most dissimilar)',
+            options: ['nearest', 'furthest'],
+            default: 'nearest',
+        }),
+    };
+    static args = {
+        face_id: Args.string({ description: 'Face username', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FaceNeighbors);
+        const client = this.makeClient(flags);
+        const params = {
+            k: String(flags.k),
+            component: flags.component,
+            direction: flags.direction,
+        };
+        let data;
+        try {
+            data = await client.get(`/v1/faces/${args.face_id}/neighbors`, { params });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled()) {
+            const res = data;
+            const label = res.direction === 'nearest' ? 'Nearest' : 'Most dissimilar';
+            this.log(`${label} neighbors to ${res.face} (by ${res.component}):`);
+            this.log('');
+            if (res.neighbors.length === 0) {
+                this.log('  (none)');
+            }
+            else {
+                for (const [i, n] of res.neighbors.entries()) {
+                    const updated = new Date(n.centroid_updated_at * 1000).toISOString().slice(0, 10);
+                    this.log(`  ${i + 1}. ${n.face.padEnd(20)} ${n.similarity.toFixed(2)}   (centroid updated ${updated})`);
+                }
+            }
+        }
+        return data;
+    }
+}