faces-cli 1.6.0 → 1.6.2

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,48 @@
+import { Args, Flags } from '@oclif/core';
+import fs from 'node:fs';
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.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;
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/team-catalog.d.ts

@@ -0,0 +1,16 @@
+export declare const TEAMS_DIR: string;
+export interface TeamFrontmatter {
+    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,99 @@
+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 = ['---'];
+    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 === '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`);
+        }
+    }
+}