faces-cli 1.6.1 → 1.6.3

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

@@ -0,0 +1,35 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class FaceTagList extends BaseCommand {
+    static description = 'List tags on a face';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    static args = {
+        alias: Args.string({ description: 'Face alias', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FaceTagList);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get(`/v1/iam/${args.alias}/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/remove.d.ts

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

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

@@ -0,0 +1,40 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+import { CatalogService } from '../../../catalog.js';
+export default class FaceTagRemove extends BaseCommand {
+    static description = 'Remove a tag from a face';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    static args = {
+        alias: Args.string({ description: 'Face alias', required: true }),
+        tag: Args.string({ description: 'Tag to remove', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FaceTagRemove);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.delete(`/v1/iam/${args.alias}/tags/${encodeURIComponent(args.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;
+        }
+        // Refresh tags in local catalog
+        try {
+            const tagResp = await client.get(`/v1/iam/${args.alias}/tags`);
+            new CatalogService().updateTags(args.alias, tagResp.tags ?? []);
+        }
+        catch { /* non-fatal */ }
+        if (!this.jsonEnabled())
+            this.log(`Removed tag '${args.tag}' from ${args.alias}`);
+        return data;
+    }
+}

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

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../../base.js';
+export default class FaceTagSet 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/set.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 FaceTagSet extends BaseCommand {
+    static description = 'Replace all tags on a face';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        tag: Flags.string({ description: 'Tag to set (repeatable, replaces all)', multiple: true, required: true }),
+    };
+    static args = {
+        alias: Args.string({ description: 'Face alias', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FaceTagSet);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.put(`/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/teams.d.ts

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

@@ -0,0 +1,29 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class FaceTeams extends BaseCommand {
+    static description = "Set a face's team memberships (replaces all)";
+    static flags = {
+        ...BaseCommand.baseFlags,
+        team: Flags.string({ description: 'Team ID (repeatable, replaces all memberships)', multiple: true, required: true }),
+    };
+    static args = {
+        alias: Args.string({ description: 'Face alias', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FaceTeams);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.put(`/v1/faces/${args.alias}/teams`, { body: { team_ids: flags.team } });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

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

@@ -4,6 +4,7 @@ export default class FaceUpdate extends BaseCommand {
     static flags: {
         name: import("@oclif/core/interfaces").OptionFlag<string | undefined, 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/update.js

@@ -2,13 +2,14 @@ import { Args, 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 FaceUpdate extends BaseCommand {
     static description = "Update a face's metadata";
     static flags = {
         ...BaseCommand.baseFlags,
         name: Flags.string({ description: 'New display name' }),
-        description: Flags.string({ description: 'Description for local catalog' }),
+        description: Flags.string({ description: 'Plain-text description / bio (max 1500 chars)' }),
+        tag: Flags.string({ description: 'Replace all tags (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: 'New boolean formula (synthetic faces only)' }),
         attr: Flags.string({ description: 'Update attribute KEY=VALUE (repeatable)', multiple: true }),
@@ -39,12 +40,13 @@ export default class FaceUpdate extends BaseCommand {
             payload.default_tools = flags.tool;
         if (flags['default-model'])
             payload.default_model = flags['default-model'];
-        const hasApiFields = Object.keys(payload).length > 0;
-        const hasDescription = Boolean(flags.description);
-        if (!hasApiFields && !hasDescription)
+        if (flags.description !== undefined)
+            payload.description = flags.description;
+        const hasTags = flags.tag && flags.tag.length > 0;
+        if (Object.keys(payload).length === 0 && !hasTags)
             this.error('Provide at least one field to update.');
         let data;
-        if (hasApiFields) {
+        if (Object.keys(payload).length > 0) {
             try {
                 data = await client.patch(`/v1/faces/${args.face_id}`, { body: payload });
             }
@@ -55,7 +57,6 @@ export default class FaceUpdate extends BaseCommand {
             }
         }
         else {
-            // description-only update: fetch current face data for catalog
             try {
                 data = await client.get(`/v1/faces/${args.face_id}`);
             }
@@ -65,17 +66,39 @@ export default class FaceUpdate extends BaseCommand {
                 throw err;
             }
         }
+        // Replace tags if provided
+        let currentTags;
+        if (hasTags) {
+            try {
+                const tagResp = await client.put(`/v1/iam/${args.face_id}/tags`, { body: { tags: flags.tag } });
+                currentTags = tagResp.tags ?? flags.tag;
+            }
+            catch (err) {
+                if (err instanceof FacesAPIError)
+                    this.warn(`Tags failed (${err.statusCode}): ${err.message}`);
+            }
+        }
         const face = data;
         if (Array.isArray(face.warnings) && face.warnings.length > 0) {
             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);
-        }
+        // Add tags to response if we set them
+        if (currentTags)
+            face.tags = currentTags;
+        // Rename basic_facts → attributes
+        renameFaceFields(face);
+        // Write to local catalog
         try {
             const catalog = new CatalogService();
-            catalog.writeFace(face, flags.description);
+            catalog.writeFace({
+                ...face,
+                basic_facts: face.attributes,
+                tags: face.tags ?? undefined,
+                description: face.description ?? undefined,
+                default_model: face.default_model,
+                formula: face.formula,
+            });
         }
         catch { /* catalog errors are non-fatal */ }
         if (!this.jsonEnabled())

package/dist/commands/team/add.d.ts

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

package/dist/commands/team/add.js

@@ -0,0 +1,68 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+import { TeamCatalogService } from '../../team-catalog.js';
+export default class TeamAdd extends BaseCommand {
+    static description = 'Add face(s) to a team';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        face: Flags.string({ description: 'Face alias to add (repeatable)', multiple: true, required: true }),
+    };
+    static args = {
+        team_id: Args.string({ description: 'Team ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TeamAdd);
+        const client = this.makeClient(flags);
+        // Resolve aliases to iam_ids
+        const iamIds = [];
+        for (const alias of flags.face) {
+            try {
+                const face = await client.get(`/v1/faces/${alias}`);
+                const id = (face.uid ?? face.id ?? face.iam_id);
+                if (!id)
+                    this.error(`Could not resolve iam_id for face '${alias}'`);
+                iamIds.push(id);
+            }
+            catch (err) {
+                if (err instanceof FacesAPIError)
+                    this.error(`Error resolving '${alias}' (${err.statusCode}): ${err.message}`);
+                throw err;
+            }
+        }
+        let data;
+        try {
+            if (iamIds.length === 1) {
+                data = await client.post(`/v1/teams/${args.team_id}/members`, { body: { iam_id: iamIds[0] } });
+            }
+            else {
+                data = await client.post(`/v1/teams/${args.team_id}/members`, { body: { iam_ids: iamIds } });
+            }
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        // Update local TEAM.md — find by team ID and add aliases
+        try {
+            const teamCatalog = new TeamCatalogService();
+            for (const name of teamCatalog.listTeams()) {
+                const team = teamCatalog.readTeam(name);
+                if (team?.frontmatter.id === args.team_id) {
+                    const members = new Set(team.frontmatter.members ?? []);
+                    for (const alias of flags.face)
+                        members.add(alias);
+                    team.frontmatter.members = [...members];
+                    teamCatalog.writeTeam(name, team.frontmatter, team.body || undefined);
+                    break;
+                }
+            }
+        }
+        catch { /* non-fatal */ }
+        if (!this.jsonEnabled()) {
+            this.log(`Added ${flags.face.join(', ')} to team.`);
+        }
+        return data;
+    }
+}

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

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base.js';
+export default class TeamCreate extends BaseCommand {
+    static description: string;
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        protocol: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'protocol-file': 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>;
+        '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/team/create.js

@@ -0,0 +1,69 @@
+import { Flags } from '@oclif/core';
+import fs from 'node:fs';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+import { TeamCatalogService } from '../../team-catalog.js';
+export default class TeamCreate extends BaseCommand {
+    static description = 'Create a new team';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        name: Flags.string({ description: 'Team name', required: true }),
+        description: Flags.string({ description: 'Plain-text team description (max 1500 chars)' }),
+        protocol: Flags.string({ description: 'Protocol content (mermaid diagram or markdown, max 1000 words)' }),
+        'protocol-file': Flags.string({ description: 'Read protocol from file' }),
+        tag: Flags.string({ description: 'Tag label (repeatable, lowercase)', multiple: true }),
+    };
+    async run() {
+        const { flags } = await this.parse(TeamCreate);
+        const client = this.makeClient(flags);
+        let protocol = flags.protocol;
+        if (flags['protocol-file']) {
+            if (!fs.existsSync(flags['protocol-file']))
+                this.error(`File not found: ${flags['protocol-file']}`);
+            protocol = fs.readFileSync(flags['protocol-file'], 'utf8');
+        }
+        const payload = { name: flags.name };
+        if (flags.description)
+            payload.description = flags.description;
+        if (protocol)
+            payload.protocol = protocol;
+        let data;
+        try {
+            data = await client.post('/v1/teams', { body: payload });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        const team = data;
+        // Post tags if provided
+        const tags = flags.tag ?? [];
+        if (tags.length > 0) {
+            try {
+                await client.post(`/v1/teams/${team.id}/tags`, { body: { tags } });
+                team.tags = tags;
+            }
+            catch (err) {
+                if (err instanceof FacesAPIError)
+                    this.warn(`Tags failed (${err.statusCode}): ${err.message}`);
+            }
+        }
+        // Write local TEAM.md
+        try {
+            const teamCatalog = new TeamCatalogService();
+            const slug = String(team.name).toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+            teamCatalog.writeTeam(slug, {
+                id: team.id,
+                name: team.name,
+                description: team.description ?? undefined,
+                tags: team.tags ?? undefined,
+                members: [],
+            }, team.protocol ?? protocol ?? undefined);
+        }
+        catch { /* non-fatal */ }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/team/delete.d.ts

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

package/dist/commands/team/delete.js

@@ -0,0 +1,44 @@
+import { Args, Flags } from '@oclif/core';
+import { createInterface } from 'node:readline';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class TeamDelete extends BaseCommand {
+    static description = 'Delete a team';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        yes: Flags.boolean({ description: 'Skip confirmation', default: false }),
+    };
+    static args = {
+        team_id: Args.string({ description: 'Team ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TeamDelete);
+        const client = this.makeClient(flags);
+        if (!flags.yes) {
+            const confirmed = await this.confirm(`Delete team '${args.team_id}'?`);
+            if (!confirmed)
+                this.error('Aborted.');
+        }
+        let data;
+        try {
+            data = await client.delete(`/v1/teams/${args.team_id}`);
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+    confirm(message) {
+        return new Promise((resolve) => {
+            const rl = createInterface({ input: process.stdin, output: process.stdout });
+            rl.question(`${message} [y/N] `, (answer) => {
+                rl.close();
+                resolve(answer.toLowerCase() === 'y');
+            });
+        });
+    }
+}

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

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

package/dist/commands/team/get.js

@@ -0,0 +1,28 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class TeamGet extends BaseCommand {
+    static description = 'Get a team by ID';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    static args = {
+        team_id: Args.string({ description: 'Team ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TeamGet);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get(`/v1/teams/${args.team_id}`);
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

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

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../base.js';
+export default class TeamList 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/team/list.js

@@ -0,0 +1,40 @@
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class TeamList extends BaseCommand {
+    static description = 'List your teams';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(TeamList);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get('/v1/me/teams');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        const resp = data;
+        let teams = resp.data ?? data;
+        // Filter out personal Guild using kind field
+        teams = teams.filter(t => t.kind !== 'personal');
+        if (this.jsonEnabled())
+            return teams;
+        if (teams.length === 0) {
+            this.log('(no teams)');
+        }
+        else {
+            const nameWidth = Math.max(...teams.map(t => String(t.name ?? '').length));
+            for (const t of teams) {
+                const name = String(t.name ?? '').padEnd(nameWidth);
+                const members = t.member_count != null ? `  [${t.member_count} members]` : '';
+                const desc = t.description ? `  ${String(t.description).slice(0, 50)}` : '';
+                this.log(`${t.id}  ${name}${members}${desc}`);
+            }
+        }
+        return teams;
+    }
+}

package/dist/commands/team/members.d.ts

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