faces-cli 1.6.1 → 1.6.3

package/dist/commands/team/members.js

@@ -0,0 +1,28 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class TeamMembers extends BaseCommand {
+    static description = 'List members of a team';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    static args = {
+        team_id: Args.string({ description: 'Team ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TeamMembers);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get(`/v1/teams/${args.team_id}/members`);
+        }
+        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/remove.d.ts

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

package/dist/commands/team/remove.js

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

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

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

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

@@ -0,0 +1,29 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class TeamTagAdd extends BaseCommand {
+    static description = 'Add tags to a team (appends, idempotent)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        tag: Flags.string({ description: 'Tag 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(TeamTagAdd);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.post(`/v1/teams/${args.team_id}/tags`, { body: { tags: flags.tag } });
+        }
+        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/tag/list.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base.js';
+export default class TeamTagList 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/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 TeamTagList extends BaseCommand {
+    static description = 'List tags on a team';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    static args = {
+        team_id: Args.string({ description: 'Team ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TeamTagList);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get(`/v1/teams/${args.team_id}/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/team/tag/remove.d.ts

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

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

@@ -0,0 +1,29 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class TeamTagRemove extends BaseCommand {
+    static description = 'Remove a tag from a team';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    static args = {
+        team_id: Args.string({ description: 'Team ID', required: true }),
+        tag: Args.string({ description: 'Tag to remove', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TeamTagRemove);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.delete(`/v1/teams/${args.team_id}/tags/${encodeURIComponent(args.tag)}`);
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled())
+            this.log(`Removed tag '${args.tag}' from team.`);
+        return data;
+    }
+}

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

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

package/dist/commands/team/tag/set.js

@@ -0,0 +1,29 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class TeamTagSet extends BaseCommand {
+    static description = 'Replace all tags on a team';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        tag: Flags.string({ description: 'Tag to set (repeatable, replaces all)', multiple: true, required: true }),
+    };
+    static args = {
+        team_id: Args.string({ description: 'Team ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TeamTagSet);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.put(`/v1/teams/${args.team_id}/tags`, { body: { tags: flags.tag } });
+        }
+        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/update.d.ts

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

@@ -0,0 +1,78 @@
+import { Args, 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 TeamUpdate extends BaseCommand {
+    static description = 'Update a team';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        name: Flags.string({ description: 'New team name' }),
+        description: Flags.string({ description: 'New description (max 1500 chars)' }),
+        protocol: Flags.string({ description: 'New protocol content' }),
+        'protocol-file': Flags.string({ description: 'Read protocol from file' }),
+    };
+    static args = {
+        team_id: Args.string({ description: 'Team ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TeamUpdate);
+        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 = {};
+        if (flags.name)
+            payload.name = flags.name;
+        if (flags.description !== undefined)
+            payload.description = flags.description;
+        if (protocol !== undefined)
+            payload.protocol = protocol;
+        if (Object.keys(payload).length === 0)
+            this.error('Provide at least one field to update.');
+        let data;
+        try {
+            data = await client.patch(`/v1/teams/${args.team_id}`, { body: payload });
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        // Update local TEAM.md
+        try {
+            const team = data;
+            const teamCatalog = new TeamCatalogService();
+            const slug = String(team.name).toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+            // Fetch members for the local file
+            let members = [];
+            try {
+                const membersResp = await client.get(`/v1/teams/${args.team_id}/members`);
+                // Members come as iam_ids — we'd need to resolve, but for now store what we have
+                members = (membersResp.data ?? []).map(m => m.iam_id);
+            }
+            catch { /* proceed without members */ }
+            // Fetch tags
+            let tags = [];
+            try {
+                const tagResp = await client.get(`/v1/teams/${args.team_id}/tags`);
+                tags = tagResp.tags ?? [];
+            }
+            catch { /* proceed */ }
+            teamCatalog.writeTeam(slug, {
+                id: args.team_id,
+                name: team.name,
+                description: team.description ?? undefined,
+                tags,
+                members,
+            }, team.protocol ?? undefined);
+        }
+        catch { /* non-fatal */ }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/team-catalog.d.ts

@@ -0,0 +1,17 @@
+export declare const TEAMS_DIR: string;
+export interface TeamFrontmatter {
+    id?: string;
+    name: string;
+    description?: string;
+    tags?: string[];
+    members?: string[];
+}
+export declare class TeamCatalogService {
+    writeTeam(name: string, fm: TeamFrontmatter, protocol?: string | null): void;
+    readTeam(name: string): {
+        frontmatter: TeamFrontmatter;
+        body: string;
+    } | null;
+    listTeams(): string[];
+    deleteTeam(name: string): void;
+}

package/dist/team-catalog.js

@@ -0,0 +1,104 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+export const TEAMS_DIR = path.join(os.homedir(), '.faces', 'teams');
+function quoteYaml(value) {
+    if (/[:#\[\]{}&*!|>'"%@`\n]/.test(value) || value !== value.trim() || value === '') {
+        return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+    return value;
+}
+function serializeFrontmatter(fm) {
+    const lines = ['---'];
+    if (fm.id)
+        lines.push(`id: ${fm.id}`);
+    lines.push(`name: ${quoteYaml(fm.name)}`);
+    if (fm.description)
+        lines.push(`description: ${quoteYaml(fm.description)}`);
+    if (fm.tags && fm.tags.length > 0) {
+        lines.push(`tags: [${fm.tags.join(', ')}]`);
+    }
+    if (fm.members && fm.members.length > 0) {
+        lines.push(`members: [${fm.members.join(', ')}]`);
+    }
+    lines.push('---');
+    return lines.join('\n');
+}
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!match)
+        return { frontmatter: null, body: content };
+    const yamlBlock = match[1];
+    const body = match[2];
+    const fm = {};
+    for (const line of yamlBlock.split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx < 0)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        const val = line.slice(colonIdx + 1).trim();
+        if (key === 'id') {
+            fm.id = val.replace(/^"(.*)"$/, '$1');
+        }
+        else if (key === 'name') {
+            fm.name = val.replace(/^"(.*)"$/, '$1');
+        }
+        else if (key === 'description') {
+            fm.description = val.replace(/^"(.*)"$/, '$1');
+        }
+        else if (key === 'tags') {
+            const inner = val.replace(/^\[/, '').replace(/\]$/, '');
+            fm.tags = inner ? inner.split(',').map(s => s.trim()).filter(Boolean) : [];
+        }
+        else if (key === 'members') {
+            const inner = val.replace(/^\[/, '').replace(/\]$/, '');
+            fm.members = inner ? inner.split(',').map(s => s.trim()).filter(Boolean) : [];
+        }
+    }
+    if (!fm.name)
+        return { frontmatter: null, body: content };
+    return { frontmatter: fm, body };
+}
+export class TeamCatalogService {
+    writeTeam(name, fm, protocol) {
+        try {
+            const dir = path.join(TEAMS_DIR, name);
+            fs.mkdirSync(dir, { recursive: true });
+            const filePath = path.join(dir, 'TEAM.md');
+            const body = protocol ?? '';
+            const content = serializeFrontmatter(fm) + '\n' + body;
+            fs.writeFileSync(filePath, content);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`warn: team catalog write failed: ${msg}\n`);
+        }
+    }
+    readTeam(name) {
+        const filePath = path.join(TEAMS_DIR, name, 'TEAM.md');
+        if (!fs.existsSync(filePath))
+            return null;
+        const content = fs.readFileSync(filePath, 'utf8');
+        const parsed = parseFrontmatter(content);
+        if (!parsed.frontmatter)
+            return null;
+        return { frontmatter: parsed.frontmatter, body: parsed.body };
+    }
+    listTeams() {
+        if (!fs.existsSync(TEAMS_DIR))
+            return [];
+        return fs.readdirSync(TEAMS_DIR, { withFileTypes: true })
+            .filter(d => d.isDirectory() && fs.existsSync(path.join(TEAMS_DIR, d.name, 'TEAM.md')))
+            .map(d => d.name);
+    }
+    deleteTeam(name) {
+        try {
+            const dir = path.join(TEAMS_DIR, name);
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`warn: team catalog delete failed: ${msg}\n`);
+        }
+    }
+}

package/dist/utils.d.ts

@@ -1,5 +1,12 @@
 /**
- * Flatten basic_facts from API's nested {value, status, identification} format
+ * Flatten basic_facts/attributes from API's nested {value, status, identification} format
  * to simple {key: value} strings.
  */
-export declare function flattenBasicFacts(facts: Record<string, unknown>): Record<string, string>;
+export declare function flattenAttributes(facts: Record<string, unknown>): Record<string, string>;
+/** @deprecated Use flattenAttributes */
+export declare const flattenBasicFacts: typeof flattenAttributes;
+/**
+ * Rename basic_facts → attributes in a face response object.
+ * Mutates the object in place and returns it.
+ */
+export declare function renameFaceFields(face: Record<string, unknown>): Record<string, unknown>;

package/dist/utils.js

@@ -1,8 +1,8 @@
 /**
- * Flatten basic_facts from API's nested {value, status, identification} format
+ * Flatten basic_facts/attributes from API's nested {value, status, identification} format
  * to simple {key: value} strings.
  */
-export function flattenBasicFacts(facts) {
+export function flattenAttributes(facts) {
     const flat = {};
     for (const [k, v] of Object.entries(facts)) {
         if (typeof v === 'object' && v !== null && 'value' in v) {
@@ -14,3 +14,18 @@ export function flattenBasicFacts(facts) {
     }
     return flat;
 }
+/** @deprecated Use flattenAttributes */
+export const flattenBasicFacts = flattenAttributes;
+/**
+ * Rename basic_facts → attributes in a face response object.
+ * Mutates the object in place and returns it.
+ */
+export function renameFaceFields(face) {
+    if (face.basic_facts !== undefined) {
+        face.attributes = typeof face.basic_facts === 'object' && face.basic_facts !== null
+            ? flattenAttributes(face.basic_facts)
+            : face.basic_facts;
+        delete face.basic_facts;
+    }
+    return face;
+}