faces-cli 1.6.1 → 1.6.3

package/dist/commands/catalog/doctor.js

@@ -5,8 +5,9 @@ import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 import { loadConfig } from '../../config.js';
 import { CatalogService, CATALOG_DIR } from '../../catalog.js';
+import { TeamCatalogService } from '../../team-catalog.js';
 export default class CatalogDoctor extends BaseCommand {
-    static description = 'Diagnose and repair the local face catalog';
+    static description = 'Diagnose and repair the local face and team catalog';
     static flags = {
         ...BaseCommand.baseFlags,
         fix: Flags.boolean({ description: 'Rebuild missing or stale catalog entries from API', default: false }),
@@ -16,15 +17,17 @@ export default class CatalogDoctor extends BaseCommand {
         const { flags } = await this.parse(CatalogDoctor);
         const client = this.makeClient(flags);
         const catalog = new CatalogService();
-        // Fetch all faces from API
+        const teamCatalog = new TeamCatalogService();
+        // Fetch all faces from API (with tags)
         let remoteFaces;
         try {
-            const resp = await client.get('/v1/faces');
+            const resp = await client.get('/v1/faces?include=tags');
             const arr = resp.data ?? resp;
-            // List endpoint returns minimal fields; fetch full details for each
+            // Fetch full details for each face (tags come from list, but need description etc.)
             remoteFaces = await Promise.all(arr.map(async (f) => {
                 try {
-                    return await client.get(`/v1/faces/${f.alias}`);
+                    const full = await client.get(`/v1/faces/${f.alias}?include=tags`);
+                    return full;
                 }
                 catch {
                     return { ...f, uid: f.alias };
@@ -55,7 +58,6 @@ export default class CatalogDoctor extends BaseCommand {
                         const content = fs.readFileSync(faceMdPath, 'utf8');
                         const match = content.match(/^---\n([\s\S]*?)\n---/);
                         if (match) {
-                            // Quick parse for name and description
                             const fm = { alias: dirent.name };
                             for (const line of match[1].split('\n')) {
                                 if (line.startsWith('  '))
@@ -78,7 +80,7 @@ export default class CatalogDoctor extends BaseCommand {
             }
         }
         catch { /* continue with what we have */ }
-        // Compute diffs
+        // Compute face diffs
         const missing = [];
         const stale = [];
         const noDescription = [];
@@ -101,9 +103,21 @@ export default class CatalogDoctor extends BaseCommand {
             if (!remoteByAlias.has(alias))
                 orphaned.push(alias);
         }
+        // Check teams
+        let remoteTeams = [];
+        const localTeamNames = new Set(teamCatalog.listTeams());
+        try {
+            const resp = await client.get('/v1/me/teams');
+            remoteTeams = (resp.data ?? resp)
+                .filter(t => t.kind !== 'personal');
+        }
+        catch { /* proceed */ }
+        const missingTeams = remoteTeams.filter(t => {
+            const slug = String(t.name).toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+            return !localTeamNames.has(slug);
+        });
         const doFix = flags.fix || flags.generate;
         if (!doFix) {
-            // Diagnostic mode
             const issues = [];
             if (missing.length > 0)
                 issues.push(`${missing.length} face(s) missing from catalog`);
@@ -113,6 +127,8 @@ export default class CatalogDoctor extends BaseCommand {
                 issues.push(`${orphaned.length} orphaned catalog entries (face deleted on server)`);
             if (noDescription.length > 0)
                 issues.push(`${noDescription.length} face(s) without a description`);
+            if (missingTeams.length > 0)
+                issues.push(`${missingTeams.length} team(s) missing from local catalog`);
             if (issues.length === 0) {
                 this.log('Catalog is healthy.');
             }
@@ -125,28 +141,63 @@ export default class CatalogDoctor extends BaseCommand {
                     this.log('Run faces catalog:doctor --generate to also create missing descriptions');
                 }
             }
-            return { missing: missing.length, stale: stale.length, orphaned: orphaned.length, noDescription: noDescription.length };
+            return { missing: missing.length, stale: stale.length, orphaned: orphaned.length, noDescription: noDescription.length, missingTeams: missingTeams.length };
         }
-        // Fix mode: rebuild missing and stale entries
+        // Fix mode: rebuild face entries
         let fixed = 0;
         for (const face of [...missing, ...stale]) {
             catalog.writeFace(face);
             fixed++;
         }
-        // Also refresh faces that exist but might have stale attributes
+        // Refresh all existing faces (attributes, tags, description)
         for (const [alias, remote] of remoteByAlias) {
             if (!missing.some((f) => f.alias === alias) && !stale.some((f) => f.alias === alias)) {
-                // Face exists locally and name matches — still refresh attributes
                 catalog.writeFace(remote);
             }
         }
-        // Remove orphans
+        // Remove orphaned faces
         let removed = 0;
         for (const alias of orphaned) {
             catalog.deleteFace(alias);
             removed++;
         }
-        this.log(`Fixed ${fixed} catalog entries, removed ${removed} orphans.`);
+        // Sync teams
+        let teamsSynced = 0;
+        // Build uid→alias map for member resolution
+        const uidToAlias = new Map();
+        for (const f of remoteFaces) {
+            if (f.uid)
+                uidToAlias.set(f.uid, f.alias);
+        }
+        for (const team of remoteTeams) {
+            const teamId = team.id;
+            const slug = String(team.name).toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+            // Fetch members and tags
+            let memberAliases = [];
+            try {
+                const membersResp = await client.get(`/v1/teams/${teamId}/members`);
+                memberAliases = (membersResp.data ?? []).map(m => {
+                    const iamId = m.iam_id;
+                    return uidToAlias.get(iamId) ?? iamId;
+                });
+            }
+            catch { /* proceed */ }
+            let tags = [];
+            try {
+                const tagResp = await client.get(`/v1/teams/${teamId}/tags`);
+                tags = tagResp.tags ?? [];
+            }
+            catch { /* proceed */ }
+            teamCatalog.writeTeam(slug, {
+                id: teamId,
+                name: team.name,
+                description: team.description ?? undefined,
+                tags,
+                members: memberAliases,
+            }, team.protocol ?? undefined);
+            teamsSynced++;
+        }
+        this.log(`Fixed ${fixed} face(s), removed ${removed} orphan(s), synced ${teamsSynced} team(s).`);
         // Generate mode: create missing descriptions
         if (flags.generate && noDescription.length > 0) {
             const cfg = loadConfig();
@@ -175,7 +226,12 @@ export default class CatalogDoctor extends BaseCommand {
                         text = resp.choices?.[0]?.message?.content;
                     }
                     if (text) {
-                        catalog.writeFace(remote, text.trim());
+                        const desc = text.trim();
+                        catalog.writeFace({ ...remote, description: desc });
+                        try {
+                            await client.patch(`/v1/faces/${alias}`, { body: { description: desc } });
+                        }
+                        catch { /* non-fatal */ }
                         generated++;
                         this.log(`  ${alias}: done`);
                     }
@@ -191,6 +247,6 @@ export default class CatalogDoctor extends BaseCommand {
             this.log(`Generated ${generated} description(s).`);
         }
         catalog.rebuildIndex();
-        return { fixed, removed, generated: flags.generate ? noDescription.length : 0 };
+        return { fixed, removed, teamsSynced, generated: flags.generate ? noDescription.length : 0 };
     }
 }

package/dist/commands/catalog/restore.js

@@ -6,7 +6,7 @@ import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 import { CatalogService } from '../../catalog.js';
 export default class CatalogRestore extends BaseCommand {
-    static description = 'Restore faces and source material from a backup snapshot';
+    static description = 'Restore faces, teams, and source material from a backup snapshot';
     static flags = {
         ...BaseCommand.baseFlags,
         compile: Flags.boolean({ description: 'Run compile:all after restoring', default: false }),
@@ -22,23 +22,23 @@ export default class CatalogRestore extends BaseCommand {
         if (!fs.existsSync(filePath))
             this.error(`Backup file not found: ${filePath}`);
         const backup = JSON.parse(fs.readFileSync(filePath, 'utf8'));
-        if (backup.version !== 1)
+        if (backup.version !== 1 && backup.version !== 2)
             this.error(`Unsupported backup version: ${backup.version}`);
         if (!json) {
             this.log(`Restoring from: ${filePath}`);
             this.log(`  Created: ${backup.created_at}`);
-            this.log(`  Faces: ${backup.faces.length}\n`);
+            this.log(`  Faces: ${backup.faces.length}, Teams: ${backup.teams?.length ?? 0}\n`);
         }
         const catalog = new CatalogService();
         let facesCreated = 0;
         let facesSkipped = 0;
         let docsUploaded = 0;
         let threadsUploaded = 0;
+        let teamsCreated = 0;
         for (const face of backup.faces) {
             if (!json)
                 process.stderr.write(`${face.alias}: `);
-            // Create face
-            const created = await this.createFace(client, face, json);
+            const created = await this.createFace(client, face);
             if (!created) {
                 facesSkipped++;
                 if (!json)
@@ -46,9 +46,16 @@ export default class CatalogRestore extends BaseCommand {
                 continue;
             }
             facesCreated++;
+            // Post tags
+            if (face.tags && face.tags.length > 0) {
+                try {
+                    await client.post(`/v1/iam/${face.alias}/tags`, { body: { tags: face.tags } });
+                }
+                catch { /* non-fatal */ }
+            }
             // Write to local catalog
             try {
-                catalog.writeFace({ alias: face.alias, name: face.name, basic_facts: face.basic_facts });
+                catalog.writeFace({ alias: face.alias, name: face.name, basic_facts: face.basic_facts }, face.description ?? undefined);
             }
             catch { /* non-fatal */ }
             // Upload documents
@@ -68,7 +75,7 @@ export default class CatalogRestore extends BaseCommand {
                         process.stderr.write(`\n    warn: doc upload failed: ${msg}\n    `);
                 }
             }
-            // Upload threads — create thread then PATCH messages in bulk
+            // Upload threads
             for (const thread of face.threads) {
                 try {
                     const createPayload = { alias: face.alias };
@@ -76,7 +83,6 @@ export default class CatalogRestore extends BaseCommand {
                         createPayload.label = thread.label;
                     const created = await client.post('/v1/compile/threads', { body: createPayload });
                     const threadId = created.thread_id;
-                    // Overwrite the auto-generated messages with the backup messages
                     if (thread.messages.length > 0) {
                         await client.patch(`/v1/compile/threads/${threadId}/messages`, {
                             body: { messages: thread.messages },
@@ -93,21 +99,69 @@ export default class CatalogRestore extends BaseCommand {
             if (!json)
                 process.stderr.write(`${face.documents.length} doc(s), ${face.threads.length} thread(s)\n`);
         }
+        // Restore teams (v2+)
+        if (backup.teams && backup.teams.length > 0) {
+            if (!json)
+                this.log(`\nRestoring ${backup.teams.length} team(s)...`);
+            for (const team of backup.teams) {
+                if (!json)
+                    process.stderr.write(`  ${team.name}: `);
+                try {
+                    const payload = { name: team.name };
+                    if (team.description)
+                        payload.description = team.description;
+                    if (team.protocol)
+                        payload.protocol = team.protocol;
+                    const created = await client.post('/v1/teams', { body: payload });
+                    const teamId = created.id;
+                    // Add tags
+                    if (team.tags.length > 0) {
+                        try {
+                            await client.post(`/v1/teams/${teamId}/tags`, { body: { tags: team.tags } });
+                        }
+                        catch { /* non-fatal */ }
+                    }
+                    // Add members (resolve aliases to iam_ids)
+                    for (const alias of team.members) {
+                        try {
+                            const face = await client.get(`/v1/faces/${alias}`);
+                            const iamId = (face.uid ?? face.id ?? face.iam_id);
+                            if (iamId) {
+                                await client.post(`/v1/teams/${teamId}/members`, { body: { iam_id: iamId } });
+                            }
+                        }
+                        catch { /* member may not exist yet */ }
+                    }
+                    teamsCreated++;
+                    if (!json)
+                        process.stderr.write(`${team.members.length} member(s)\n`);
+                }
+                catch (err) {
+                    const msg = err instanceof FacesAPIError ? `${err.statusCode}: ${err.message}` : String(err);
+                    if (!json)
+                        process.stderr.write(`failed: ${msg}\n`);
+                }
+            }
+        }
         if (!json) {
             this.log(`\nRestore complete:`);
             this.log(`  Faces created: ${facesCreated}, skipped: ${facesSkipped}`);
             this.log(`  Documents uploaded: ${docsUploaded}`);
             this.log(`  Threads uploaded: ${threadsUploaded}`);
+            if (teamsCreated > 0)
+                this.log(`  Teams created: ${teamsCreated}`);
         }
         if (flags.compile) {
             if (!json)
                 this.log('\nRunning compile:all...\n');
             await this.config.runCommand('compile:all', json ? ['--json'] : []);
         }
-        return { faces_created: facesCreated, faces_skipped: facesSkipped, documents: docsUploaded, threads: threadsUploaded };
+        return { faces_created: facesCreated, faces_skipped: facesSkipped, documents: docsUploaded, threads: threadsUploaded, teams_created: teamsCreated };
     }
-    async createFace(client, face, _json) {
+    async createFace(client, face) {
         const payload = { name: face.name, alias: face.alias };
+        if (face.description)
+            payload.description = face.description;
         if (face.formula) {
             payload.formula = face.formula;
             if (face.default_model)
@@ -127,7 +181,6 @@ export default class CatalogRestore extends BaseCommand {
         }
         catch (err) {
             if (err instanceof FacesAPIError && err.statusCode === 400) {
-                // likely "already have a face with alias"
                 return false;
             }
             throw err;

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

@@ -5,6 +5,7 @@ export default class FaceCreate extends BaseCommand {
         name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         alias: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        tag: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'default-model': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         formula: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         attr: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/face/create.js

@@ -2,14 +2,15 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 import { CatalogService } from '../../catalog.js';
-import { flattenBasicFacts } from '../../utils.js';
+import { renameFaceFields } from '../../utils.js';
 export default class FaceCreate extends BaseCommand {
     static description = 'Create a new face';
     static flags = {
         ...BaseCommand.baseFlags,
         name: Flags.string({ description: 'Display name', required: true }),
         alias: Flags.string({ description: 'Unique alias slug', required: true }),
-        description: Flags.string({ description: 'Description for local catalog' }),
+        description: Flags.string({ description: 'Plain-text description / bio (max 1500 chars)' }),
+        tag: Flags.string({ description: 'Tag label (repeatable, lowercase)', multiple: true }),
         'default-model': Flags.string({ description: 'Default LLM for chat (e.g. gpt-4o-mini, claude-sonnet-4-6)' }),
         formula: Flags.string({ description: 'Boolean formula over owned concrete face aliases (e.g. "a | b", "(a | b) - c"). Creates a composite face.' }),
         attr: Flags.string({ description: 'Attribute KEY=VALUE (repeatable)', multiple: true }),
@@ -23,6 +24,8 @@ export default class FaceCreate extends BaseCommand {
             this.error('--formula cannot be combined with --attr or --tool. Composite faces do not have compiled knowledge.');
         }
         const payload = { name: flags.name, alias: flags.alias };
+        if (flags.description)
+            payload.description = flags.description;
         if (flags.formula) {
             payload.formula = flags.formula;
             if (flags['default-model'])
@@ -57,12 +60,31 @@ export default class FaceCreate extends BaseCommand {
             for (const w of face.warnings)
                 this.warn(w);
         }
-        if (face.basic_facts && typeof face.basic_facts === 'object') {
-            face.basic_facts = flattenBasicFacts(face.basic_facts);
+        // Post tags if provided
+        const tags = flags.tag ?? [];
+        if (tags.length > 0) {
+            try {
+                await client.post(`/v1/iam/${flags.alias}/tags`, { body: { tags } });
+                face.tags = tags;
+            }
+            catch (err) {
+                if (err instanceof FacesAPIError)
+                    this.warn(`Tags failed (${err.statusCode}): ${err.message}`);
+            }
         }
+        // Rename basic_facts → attributes in response
+        renameFaceFields(face);
+        // Write to local catalog with tags
         try {
             const catalog = new CatalogService();
-            catalog.writeFace(face, flags.description);
+            catalog.writeFace({
+                ...face,
+                basic_facts: face.attributes,
+                tags: face.tags ?? undefined,
+                description: face.description ?? flags.description ?? undefined,
+                default_model: face.default_model,
+                formula: face.formula,
+            });
         }
         catch { /* catalog errors are non-fatal */ }
         if (!this.jsonEnabled())

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

@@ -2,6 +2,7 @@ import { BaseCommand } from '../../base.js';
 export default class FaceGet extends BaseCommand {
     static description: string;
     static flags: {
+        include: import("@oclif/core/interfaces").OptionFlag<string | undefined, 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>;

package/dist/commands/face/get.js

@@ -1,11 +1,12 @@
-import { Args } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
-import { flattenBasicFacts } from '../../utils.js';
+import { renameFaceFields } from '../../utils.js';
 export default class FaceGet extends BaseCommand {
     static description = 'Get details for a face by alias';
     static flags = {
         ...BaseCommand.baseFlags,
+        include: Flags.string({ description: 'Include extra fields: tags, teams (comma-separated)' }),
     };
     static args = {
         face_id: Args.string({ description: 'Face alias', required: true }),
@@ -13,18 +14,21 @@ export default class FaceGet extends BaseCommand {
     async run() {
         const { args, flags } = await this.parse(FaceGet);
         const client = this.makeClient(flags);
+        const path = flags.include
+            ? `/v1/faces/${args.face_id}?include=${encodeURIComponent(flags.include)}`
+            : `/v1/faces/${args.face_id}`;
         let data;
         try {
-            data = await client.get(`/v1/faces/${args.face_id}`);
+            data = await client.get(path);
         }
         catch (err) {
             if (err instanceof FacesAPIError)
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             throw err;
         }
-        const f = data;
-        if (f.basic_facts)
-            f.basic_facts = flattenBasicFacts(f.basic_facts);
+        const face = data;
+        renameFaceFields(face);
+        const f = face;
         if (!this.jsonEnabled()) {
             this.log(`alias:     ${f.alias}`);
             this.log(`uid:       ${f.uid}`);
@@ -37,9 +41,9 @@ export default class FaceGet extends BaseCommand {
             }
             else {
                 this.log(`type:      concrete`);
-                if (f.basic_facts && Object.keys(f.basic_facts).length > 0) {
-                    this.log('basic_facts:');
-                    for (const [k, v] of Object.entries(f.basic_facts)) {
+                if (f.attributes && Object.keys(f.attributes).length > 0) {
+                    this.log('attributes:');
+                    for (const [k, v] of Object.entries(f.attributes)) {
                         this.log(`  ${k}: ${v}`);
                     }
                 }

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

@@ -2,6 +2,9 @@ import { BaseCommand } from '../../base.js';
 export default class FaceList extends BaseCommand {
     static description: string;
     static flags: {
+        tag: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        team: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        include: import("@oclif/core/interfaces").OptionFlag<string | undefined, 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>;

package/dist/commands/face/list.js

@@ -1,29 +1,44 @@
+import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
-import { flattenBasicFacts } from '../../utils.js';
+import { renameFaceFields } from '../../utils.js';
 export default class FaceList extends BaseCommand {
     static description = 'List all owned faces';
     static flags = {
         ...BaseCommand.baseFlags,
+        tag: Flags.string({ description: 'Filter by tag (repeatable, AND logic)', multiple: true }),
+        team: Flags.string({ description: 'Filter by team ID (repeatable, OR logic)', multiple: true }),
+        include: Flags.string({ description: 'Include extra fields: tags, teams (comma-separated)' }),
     };
     async run() {
         const { flags } = await this.parse(FaceList);
         const client = this.makeClient(flags);
+        // Build query string manually for repeated params
+        const parts = [];
+        if (flags.tag && flags.tag.length > 0) {
+            for (const t of flags.tag)
+                parts.push(`tag=${encodeURIComponent(t)}`);
+        }
+        if (flags.team && flags.team.length > 0) {
+            for (const t of flags.team)
+                parts.push(`team_id=${encodeURIComponent(t)}`);
+        }
+        if (flags.include)
+            parts.push(`include=${encodeURIComponent(flags.include)}`);
         let data;
         try {
-            data = await client.get('/v1/faces');
+            const path = parts.length > 0 ? `/v1/faces?${parts.join('&')}` : '/v1/faces';
+            data = await client.get(path);
         }
         catch (err) {
             if (err instanceof FacesAPIError)
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             throw err;
         }
-        // Flatten basic_facts in response
+        // Rename basic_facts → attributes in response
         const raw = data.data ?? data;
         for (const f of raw) {
-            if (f.basic_facts && typeof f.basic_facts === 'object') {
-                f.basic_facts = flattenBasicFacts(f.basic_facts);
-            }
+            renameFaceFields(f);
         }
         if (!this.jsonEnabled()) {
             const faces = raw;

package/dist/commands/face/tag/add.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../../base.js';
+export default class FaceTagAdd extends BaseCommand {
+    static description: string;
+    static flags: {
+        tag: 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: {
+        alias: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/face/tag/add.js

@@ -0,0 +1,40 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+import { CatalogService } from '../../../catalog.js';
+export default class FaceTagAdd extends BaseCommand {
+    static description = 'Add tags to a face (appends, idempotent)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        tag: Flags.string({ description: 'Tag to add (repeatable)', multiple: true, required: true }),
+    };
+    static args = {
+        alias: Args.string({ description: 'Face alias', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FaceTagAdd);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.post(`/v1/iam/${args.alias}/tags`, { body: { tags: flags.tag } });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError) {
+                if (err.statusCode === 403) {
+                    this.error(`Forbidden: face '${args.alias}' is not owned by the current account. Run \`faces catalog:doctor --fix\` to sync.`);
+                }
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            }
+            throw err;
+        }
+        // Sync tags to local catalog
+        const tags = data.tags ?? [];
+        try {
+            new CatalogService().updateTags(args.alias, tags);
+        }
+        catch { /* non-fatal */ }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/face/tag/all.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../../base.js';
+export default class FaceTagAll extends BaseCommand {
+    static description: string;
+    static flags: {
+        '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/tag/all.js

@@ -0,0 +1,31 @@
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class FaceTagAll extends BaseCommand {
+    static description = 'List all tags across all your faces';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(FaceTagAll);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get('/v1/me/tags');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled()) {
+            const tags = data.tags ?? [];
+            if (tags.length === 0) {
+                this.log('(no tags)');
+            }
+            else {
+                this.log(tags.join(', '));
+            }
+        }
+        return data;
+    }
+}

package/dist/commands/face/tag/list.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base.js';
+export default class FaceTagList extends BaseCommand {
+    static description: string;
+    static flags: {
+        '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: {
+        alias: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<unknown>;
+}