faces-cli 1.5.5 → 1.5.7

package/dist/commands/catalog/manyfaced.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from '../../base.js';
+export default class CatalogManyfaced extends BaseCommand {
+    static description: string;
+    static flags: {
+        skill: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        install: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'skills-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        refresh: 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>;
+    };
+    run(): Promise<unknown>;
+    private fetchIndex;
+    private listSkills;
+    private showSkill;
+    private installSkill;
+}

package/dist/commands/catalog/manyfaced.js

@@ -0,0 +1,225 @@
+import { Flags } from '@oclif/core';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { BaseCommand } from '../../base.js';
+const GITHUB_REPO = 'facessh/manyfaced';
+const GITHUB_API = `https://api.github.com/repos/${GITHUB_REPO}`;
+const CACHE_PATH = path.join(os.homedir(), '.faces', 'manyfaced-index.json');
+const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return {};
+    const fm = {};
+    for (const line of match[1].split('\n')) {
+        const ci = line.indexOf(':');
+        if (ci < 0)
+            continue;
+        const key = line.slice(0, ci).trim();
+        const val = line.slice(ci + 1).trim().replace(/^["']|["']$/g, '');
+        if (key && val)
+            fm[key] = val;
+    }
+    return fm;
+}
+async function githubGet(urlPath) {
+    const resp = await fetch(`${GITHUB_API}${urlPath}`, {
+        headers: { Accept: 'application/vnd.github.v3+json', 'User-Agent': 'faces-cli' },
+    });
+    if (!resp.ok) {
+        const body = await resp.text().catch(() => '');
+        throw new Error(`GitHub API ${resp.status}: ${body.slice(0, 200)}`);
+    }
+    return resp.json();
+}
+async function githubGetFile(filePath) {
+    const data = (await githubGet(`/contents/${filePath}`));
+    if (!data.content)
+        throw new Error(`No content for ${filePath}`);
+    return Buffer.from(data.content, 'base64').toString('utf8');
+}
+function loadCache() {
+    try {
+        if (!fs.existsSync(CACHE_PATH))
+            return null;
+        const raw = JSON.parse(fs.readFileSync(CACHE_PATH, 'utf8'));
+        if (Date.now() - raw.fetched_at > CACHE_TTL_MS)
+            return null;
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+function saveCache(index) {
+    const dir = path.dirname(CACHE_PATH);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(CACHE_PATH, JSON.stringify(index, null, 2));
+}
+export default class CatalogManyfaced extends BaseCommand {
+    static description = 'Browse and install community manyfaced skills from github.com/facessh/manyfaced';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        skill: Flags.string({ description: 'Show details for a specific skill' }),
+        install: Flags.string({ description: 'Install a skill by name' }),
+        'skills-dir': Flags.string({
+            description: 'Directory to install skills into (required for --install)',
+        }),
+        refresh: Flags.boolean({
+            description: 'Force refresh the skill index (ignore cache)',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CatalogManyfaced);
+        if (flags.install) {
+            return this.installSkill(flags.install, flags['skills-dir']);
+        }
+        if (flags.skill) {
+            return this.showSkill(flags.skill);
+        }
+        return this.listSkills(flags.refresh);
+    }
+    async fetchIndex(forceRefresh) {
+        if (!forceRefresh) {
+            const cached = loadCache();
+            if (cached)
+                return cached.skills;
+        }
+        const entries = (await githubGet('/contents/'));
+        const dirs = entries.filter((e) => e.type === 'dir' && !e.name.startsWith('.'));
+        const skills = [];
+        for (const dir of dirs) {
+            try {
+                const skillMd = await githubGetFile(`${dir.name}/SKILL.md`);
+                const fm = parseFrontmatter(skillMd);
+                skills.push({
+                    name: dir.name,
+                    description: fm.description || '(no description)',
+                });
+            }
+            catch {
+                skills.push({ name: dir.name, description: '(could not read SKILL.md)' });
+            }
+        }
+        saveCache({ fetched_at: Date.now(), skills });
+        return skills;
+    }
+    async listSkills(refresh) {
+        const skills = await this.fetchIndex(refresh);
+        if (skills.length === 0) {
+            this.log('No manyfaced skills found in the community catalog.');
+            return { skills: [] };
+        }
+        if (this.jsonEnabled())
+            return { skills };
+        const nameWidth = Math.max(30, ...skills.map((s) => s.name.length + 2));
+        this.log('');
+        this.log(`${'NAME'.padEnd(nameWidth)}DESCRIPTION`);
+        this.log(`${'-'.repeat(nameWidth)}${'-'.repeat(50)}`);
+        for (const s of skills) {
+            this.log(`${s.name.padEnd(nameWidth)}${s.description.slice(0, 70)}`);
+        }
+        this.log('');
+        this.log(`${skills.length} skills available. Use --skill NAME for details, --install NAME to install.`);
+        return { skills };
+    }
+    async showSkill(name) {
+        let readme;
+        try {
+            readme = await githubGetFile(`${name}/README.md`);
+        }
+        catch {
+            this.error(`Skill '${name}' not found. Run 'faces catalog:manyfaced' to see available skills.`);
+        }
+        if (this.jsonEnabled()) {
+            let skillMd = '';
+            try {
+                skillMd = await githubGetFile(`${name}/SKILL.md`);
+            }
+            catch { /* ignore */ }
+            const fm = parseFrontmatter(skillMd);
+            return { name, description: fm.description, readme };
+        }
+        this.log('');
+        this.log(readme);
+        return { name, readme };
+    }
+    async installSkill(name, skillsDir) {
+        if (!skillsDir) {
+            this.error('--skills-dir is required for install. Specify where skills should be installed.\n' +
+                'Example: faces catalog:manyfaced --install ' + name + ' --skills-dir ~/.claude/skills');
+        }
+        // Verify skill exists
+        const skills = await this.fetchIndex(false);
+        const found = skills.find((s) => s.name === name);
+        if (!found) {
+            this.error(`Skill '${name}' not found. Available skills:\n` +
+                skills.map((s) => `  ${s.name}`).join('\n'));
+        }
+        // Create skills-dir if needed
+        if (!fs.existsSync(skillsDir)) {
+            fs.mkdirSync(skillsDir, { recursive: true });
+        }
+        const installDir = path.join(skillsDir, name);
+        // Fetch the full directory tree for this skill
+        process.stderr.write(`Fetching ${name}...\n`);
+        const tree = (await githubGet('/git/trees/main?recursive=1'));
+        const skillFiles = tree.tree.filter((f) => f.path.startsWith(`${name}/`) && f.type === 'blob');
+        if (skillFiles.length === 0) {
+            this.error(`No files found for skill '${name}'.`);
+        }
+        // Download and write each file
+        const faceMdFiles = [];
+        for (const file of skillFiles) {
+            const relativePath = file.path.slice(name.length + 1); // remove skill prefix
+            const destPath = path.join(installDir, relativePath);
+            const destDir = path.dirname(destPath);
+            if (!fs.existsSync(destDir))
+                fs.mkdirSync(destDir, { recursive: true });
+            process.stderr.write(`  ${relativePath}\n`);
+            const content = await githubGetFile(file.path);
+            fs.writeFileSync(destPath, content);
+            // Track FACE.md files for catalog copy
+            if (relativePath.endsWith('FACE.md') && relativePath.includes('catalog/')) {
+                faceMdFiles.push(destPath);
+            }
+        }
+        // Copy FACE.md files to local catalog
+        const catalogDir = path.join(os.homedir(), '.faces', 'catalog');
+        const installedFaces = [];
+        for (const faceMdPath of faceMdFiles) {
+            const content = fs.readFileSync(faceMdPath, 'utf8');
+            const fm = parseFrontmatter(content);
+            const alias = fm.alias || fm.facename || path.basename(path.dirname(faceMdPath));
+            const catalogFaceDir = path.join(catalogDir, alias);
+            if (!fs.existsSync(catalogFaceDir))
+                fs.mkdirSync(catalogFaceDir, { recursive: true });
+            fs.writeFileSync(path.join(catalogFaceDir, 'FACE.md'), content);
+            installedFaces.push(alias);
+        }
+        if (!this.jsonEnabled()) {
+            this.log('');
+            this.log(`Installed ${name} to ${installDir}/`);
+            this.log(`  ${skillFiles.length} files written`);
+            if (installedFaces.length > 0) {
+                this.log('');
+                this.log(`Faces added to local catalog (need creation + compilation):`);
+                for (const alias of installedFaces) {
+                    this.log(`  faces face:create --alias ${alias} --name "${alias}"`);
+                }
+                this.log('');
+                this.log('After creating each face, compile source material:');
+                this.log('  faces compile:doc ALIAS --file source.txt');
+            }
+        }
+        return {
+            skill: name,
+            install_dir: installDir,
+            files: skillFiles.length,
+            faces: installedFaces,
+        };
+    }
+}

package/dist/commands/compile/doc/pause.d.ts

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

package/dist/commands/compile/doc/pause.js

@@ -0,0 +1,29 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class CompileDocPause extends BaseCommand {
+    static description = 'Pause a running document compilation (preserves progress, resume with make)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    static args = {
+        doc_id: Args.string({ description: 'Document ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(CompileDocPause);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.post(`/v1/compile/documents/${args.doc_id}/pause`);
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled()) {
+            this.log(`Paused. Resume with: faces compile:doc:make ${args.doc_id}`);
+        }
+        return data;
+    }
+}

package/dist/commands/compile/doc/reset.d.ts

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

package/dist/commands/compile/doc/reset.js

@@ -0,0 +1,30 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class CompileDocReset extends BaseCommand {
+    static description = 'Reset document compilation progress (wipe extraction, keep content)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        yes: Flags.boolean({ description: 'Skip confirmation', default: false }),
+    };
+    static args = {
+        doc_id: Args.string({ description: 'Document ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(CompileDocReset);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.post(`/v1/compile/documents/${args.doc_id}/reset`);
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled()) {
+            this.log(`Reset. Recompile with: faces compile:doc:make ${args.doc_id}`);
+        }
+        return data;
+    }
+}

package/dist/commands/compile/thread/pause.d.ts

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

package/dist/commands/compile/thread/pause.js

@@ -0,0 +1,29 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class CompileThreadPause extends BaseCommand {
+    static description = 'Pause a running thread compilation (preserves progress, resume with make)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    static args = {
+        thread_id: Args.string({ description: 'Thread ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(CompileThreadPause);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.post(`/v1/compile/threads/${args.thread_id}/pause`);
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled()) {
+            this.log(`Paused. Resume with: faces compile:thread:make ${args.thread_id}`);
+        }
+        return data;
+    }
+}

package/dist/commands/compile/thread/reset.d.ts

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

package/dist/commands/compile/thread/reset.js

@@ -0,0 +1,30 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base.js';
+import { FacesAPIError } from '../../../client.js';
+export default class CompileThreadReset extends BaseCommand {
+    static description = 'Reset thread compilation progress (wipe extraction, keep source messages)';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        yes: Flags.boolean({ description: 'Skip confirmation', default: false }),
+    };
+    static args = {
+        thread_id: Args.string({ description: 'Thread ID', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(CompileThreadReset);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.post(`/v1/compile/threads/${args.thread_id}/reset`);
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        if (!this.jsonEnabled()) {
+            this.log(`Reset. Recompile with: faces compile:thread:make ${args.thread_id}`);
+        }
+        return data;
+    }
+}

package/oclif.manifest.json

@@ -578,10 +578,10 @@
         "whoami.js"
       ]
     },
-    "billing:balance": {
+    "catalog:doctor": {
       "aliases": [],
       "args": {},
-      "description": "Show credit balance and payment method status",
+      "description": "Diagnose and repair the local face catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -613,11 +613,23 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "fix": {
+          "description": "Rebuild missing or stale catalog entries from API",
+          "name": "fix",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "generate": {
+          "description": "Fix + generate missing descriptions via LLM",
+          "name": "generate",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:balance",
+      "id": "catalog:doctor",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -627,14 +639,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "balance.js"
+        "catalog",
+        "doctor.js"
       ]
     },
-    "billing:card-setup": {
+    "catalog:list": {
       "aliases": [],
       "args": {},
-      "description": "Get a Stripe card setup URL to save a payment method",
+      "description": "List all faces in the local catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -670,7 +682,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:card-setup",
+      "id": "catalog:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -680,14 +692,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "card-setup.js"
+        "catalog",
+        "list.js"
       ]
     },
-    "billing:checkout": {
+    "catalog:manyfaced": {
       "aliases": [],
       "args": {},
-      "description": "Get a Stripe checkout URL to upgrade your subscription plan",
+      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -720,21 +732,37 @@
           "multiple": false,
           "type": "option"
         },
-        "plan": {
-          "description": "Plan to subscribe to",
-          "name": "plan",
-          "default": "connect",
+        "skill": {
+          "description": "Show details for a specific skill",
+          "name": "skill",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "install": {
+          "description": "Install a skill by name",
+          "name": "install",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "connect"
-          ],
           "type": "option"
+        },
+        "skills-dir": {
+          "description": "Directory to install skills into (required for --install)",
+          "name": "skills-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "refresh": {
+          "description": "Force refresh the skill index (ignore cache)",
+          "name": "refresh",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:checkout",
+      "id": "catalog:manyfaced",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -744,14 +772,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "checkout.js"
+        "catalog",
+        "manyfaced.js"
       ]
     },
-    "billing:llm-costs": {
+    "billing:balance": {
       "aliases": [],
       "args": {},
-      "description": "List available LLMs and their per-token costs",
+      "description": "Show credit balance and payment method status",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -783,18 +811,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "provider": {
-          "description": "Filter by provider (e.g. openai, anthropic)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:llm-costs",
+      "id": "billing:balance",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -805,13 +826,13 @@
         "dist",
         "commands",
         "billing",
-        "llm-costs.js"
+        "balance.js"
       ]
     },
-    "billing:quota": {
+    "billing:card-setup": {
       "aliases": [],
       "args": {},
-      "description": "Show compile token quota and per-face stats",
+      "description": "Get a Stripe card setup URL to save a payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -847,7 +868,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:quota",
+      "id": "billing:card-setup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -858,13 +879,13 @@
         "dist",
         "commands",
         "billing",
-        "quota.js"
+        "card-setup.js"
       ]
     },
-    "billing:subscription": {
+    "billing:checkout": {
       "aliases": [],
       "args": {},
-      "description": "Show current plan, face count, and renewal date",
+      "description": "Get a Stripe checkout URL to upgrade your subscription plan",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -896,11 +917,22 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "plan": {
+          "description": "Plan to subscribe to",
+          "name": "plan",
+          "default": "connect",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "connect"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:subscription",
+      "id": "billing:checkout",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -911,13 +943,13 @@
         "dist",
         "commands",
         "billing",
-        "subscription.js"
+        "checkout.js"
       ]
     },
-    "billing:topup": {
+    "billing:llm-costs": {
       "aliases": [],
       "args": {},
-      "description": "Top up credit balance using saved payment method",
+      "description": "List available LLMs and their per-token costs",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -950,17 +982,9 @@
           "multiple": false,
           "type": "option"
         },
-        "amount": {
-          "description": "Top-up amount in USD (min $1)",
-          "name": "amount",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "payment-ref": {
-          "description": "Payment reference (admin/test path)",
-          "name": "payment-ref",
+        "provider": {
+          "description": "Filter by provider (e.g. openai, anthropic)",
+          "name": "provider",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -968,7 +992,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:topup",
+      "id": "billing:llm-costs",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -979,13 +1003,13 @@
         "dist",
         "commands",
         "billing",
-        "topup.js"
+        "llm-costs.js"
       ]
     },
-    "billing:usage": {
+    "billing:quota": {
       "aliases": [],
       "args": {},
-      "description": "Aggregated usage analytics",
+      "description": "Show compile token quota and per-face stats",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1017,30 +1041,56 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "billing:quota",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "billing",
+        "quota.js"
+      ]
+    },
+    "billing:subscription": {
+      "aliases": [],
+      "args": {},
+      "description": "Show current plan, face count, and renewal date",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "group-by": {
-          "description": "Group results",
-          "name": "group-by",
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "api_key",
-            "model",
-            "llm",
-            "date"
-          ],
           "type": "option"
         },
-        "from": {
-          "description": "Start date (YYYY-MM-DD)",
-          "name": "from",
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "to": {
-          "description": "End date (YYYY-MM-DD)",
-          "name": "to",
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1048,7 +1098,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:usage",
+      "id": "billing:subscription",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1059,13 +1109,13 @@
         "dist",
         "commands",
         "billing",
-        "usage.js"
+        "subscription.js"
       ]
     },
-    "catalog:doctor": {
+    "billing:topup": {
       "aliases": [],
       "args": {},
-      "description": "Diagnose and repair the local face catalog",
+      "description": "Top up credit balance using saved payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1098,22 +1148,25 @@
           "multiple": false,
           "type": "option"
         },
-        "fix": {
-          "description": "Rebuild missing or stale catalog entries from API",
-          "name": "fix",
-          "allowNo": false,
-          "type": "boolean"
+        "amount": {
+          "description": "Top-up amount in USD (min $1)",
+          "name": "amount",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "generate": {
-          "description": "Fix + generate missing descriptions via LLM",
-          "name": "generate",
-          "allowNo": false,
-          "type": "boolean"
+        "payment-ref": {
+          "description": "Payment reference (admin/test path)",
+          "name": "payment-ref",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:doctor",
+      "id": "billing:topup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1123,14 +1176,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "doctor.js"
+        "billing",
+        "topup.js"
       ]
     },
-    "catalog:list": {
+    "billing:usage": {
       "aliases": [],
       "args": {},
-      "description": "List all faces in the local catalog",
+      "description": "Aggregated usage analytics",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1162,11 +1215,38 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "group-by": {
+          "description": "Group results",
+          "name": "group-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "api_key",
+            "model",
+            "llm",
+            "date"
+          ],
+          "type": "option"
+        },
+        "from": {
+          "description": "Start date (YYYY-MM-DD)",
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "to": {
+          "description": "End date (YYYY-MM-DD)",
+          "name": "to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:list",
+      "id": "billing:usage",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1176,8 +1256,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "list.js"
+        "billing",
+        "usage.js"
       ]
     },
     "chat:chat": {
@@ -3368,6 +3448,132 @@
         "make.js"
       ]
     },
+    "compile:doc:pause": {
+      "aliases": [],
+      "args": {
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
+          "required": true
+        }
+      },
+      "description": "Pause a running document compilation (preserves progress, resume with make)",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "compile:doc:pause",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "doc",
+        "pause.js"
+      ]
+    },
+    "compile:doc:reset": {
+      "aliases": [],
+      "args": {
+        "doc_id": {
+          "description": "Document ID",
+          "name": "doc_id",
+          "required": true
+        }
+      },
+      "description": "Reset document compilation progress (wipe extraction, keep content)",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "compile:doc:reset",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "doc",
+        "reset.js"
+      ]
+    },
     "compile:thread:create": {
       "aliases": [],
       "args": {
@@ -3838,6 +4044,132 @@
         "message.js"
       ]
     },
+    "compile:thread:pause": {
+      "aliases": [],
+      "args": {
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
+          "required": true
+        }
+      },
+      "description": "Pause a running thread compilation (preserves progress, resume with make)",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "compile:thread:pause",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "thread",
+        "pause.js"
+      ]
+    },
+    "compile:thread:reset": {
+      "aliases": [],
+      "args": {
+        "thread_id": {
+          "description": "Thread ID",
+          "name": "thread_id",
+          "required": true
+        }
+      },
+      "description": "Reset thread compilation progress (wipe extraction, keep source messages)",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "env": "FACES_BASE_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "description": "JWT bearer token",
+          "env": "FACES_TOKEN",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-key": {
+          "description": "API key",
+          "env": "FACES_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "description": "Skip confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "compile:thread:reset",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "thread",
+        "reset.js"
+      ]
+    },
     "compile:thread:sync": {
       "aliases": [],
       "args": {
@@ -3899,5 +4231,5 @@
       ]
     }
   },
-  "version": "1.5.5"
+  "version": "1.5.7"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faces-cli",
-  "version": "1.5.5",
+  "version": "1.5.7",
   "description": "CLI for the Faces AI platform",
   "type": "module",
   "author": "sybileak <sybileak@proton.me>",