faces-cli 1.6.4 → 1.6.6

package/dist/commands/billing/quota.js

@@ -1,24 +1,12 @@
 import { BaseCommand } from '../../base.js';
-import { FacesAPIError } from '../../client.js';
 export default class BillingQuota extends BaseCommand {
-    static description = 'Show compile token quota and per-face stats';
+    static description = 'Show compilation stats per face (deprecated — use compile:stats)';
     static flags = {
         ...BaseCommand.baseFlags,
     };
     async run() {
-        const { flags } = await this.parse(BillingQuota);
-        const client = this.makeClient(flags);
-        let data;
-        try {
-            data = await client.get('/v1/billing/compile-quota');
-        }
-        catch (err) {
-            if (err instanceof FacesAPIError)
-                this.error(`Error (${err.statusCode}): ${err.message}`);
-            throw err;
-        }
-        if (!this.jsonEnabled())
-            this.printHuman(data);
-        return data;
+        process.stderr.write('Note: billing:quota is deprecated. Use compile:stats instead.\n');
+        await this.config.runCommand('compile:stats', this.argv);
+        return {};
     }
 }

package/dist/commands/compile/stats.d.ts

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

@@ -0,0 +1,34 @@
+import { BaseCommand } from '../../base.js';
+import { FacesAPIError } from '../../client.js';
+export default class CompileStats extends BaseCommand {
+    static description = 'Show compilation stats per face';
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(CompileStats);
+        const client = this.makeClient(flags);
+        let data;
+        try {
+            data = await client.get('/v1/billing/compile-quota');
+        }
+        catch (err) {
+            if (err instanceof FacesAPIError)
+                this.error(`Error (${err.statusCode}): ${err.message}`);
+            throw err;
+        }
+        // Rename face_id → alias in the faces array
+        const resp = data;
+        if (Array.isArray(resp.faces)) {
+            for (const f of resp.faces) {
+                if (f.face_id !== undefined) {
+                    f.alias = f.face_id;
+                    delete f.face_id;
+                }
+            }
+        }
+        if (!this.jsonEnabled())
+            this.printHuman(data);
+        return data;
+    }
+}

package/dist/commands/face/update.js

@@ -67,25 +67,28 @@ export default class FaceUpdate extends BaseCommand {
             }
         }
         // 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;
+                await client.put(`/v1/iam/${args.face_id}/tags`, { body: { tags: flags.tag } });
             }
             catch (err) {
                 if (err instanceof FacesAPIError)
                     this.warn(`Tags failed (${err.statusCode}): ${err.message}`);
             }
         }
+        // Always fetch current tags so the catalog stays in sync
+        let currentTags = [];
+        try {
+            const tagResp = await client.get(`/v1/iam/${args.face_id}/tags`);
+            currentTags = tagResp.tags ?? [];
+        }
+        catch { /* proceed without tags */ }
         const face = data;
         if (Array.isArray(face.warnings) && face.warnings.length > 0) {
             for (const w of face.warnings)
                 this.warn(w);
         }
-        // Add tags to response if we set them
-        if (currentTags)
-            face.tags = currentTags;
+        face.tags = currentTags;
         // Rename basic_facts → attributes
         renameFaceFields(face);
         // Write to local catalog

package/oclif.manifest.json

@@ -638,10 +638,10 @@
         "whoami.js"
       ]
     },
-    "billing:balance": {
+    "catalog:backup": {
       "aliases": [],
       "args": {},
-      "description": "Show credit balance and payment method status",
+      "description": "Snapshot all faces, teams, and source material for migration",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -677,7 +677,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:balance",
+      "id": "catalog:backup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -687,14 +687,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "balance.js"
+        "catalog",
+        "backup.js"
       ]
     },
-    "billing:card-setup": {
+    "catalog:doctor": {
       "aliases": [],
       "args": {},
-      "description": "Get a Stripe card setup URL to save a payment method",
+      "description": "Diagnose and repair the local face and team catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -726,11 +726,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:card-setup",
+      "id": "catalog:doctor",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -740,14 +752,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "card-setup.js"
+        "catalog",
+        "doctor.js"
       ]
     },
-    "billing:checkout": {
+    "catalog:list": {
       "aliases": [],
       "args": {},
-      "description": "Get a Stripe checkout URL to upgrade your subscription plan",
+      "description": "List all faces in the local catalog",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -779,22 +791,11 @@
           "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:checkout",
+      "id": "catalog:list",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -804,14 +805,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "checkout.js"
+        "catalog",
+        "list.js"
       ]
     },
-    "billing:llm-costs": {
+    "catalog:manyfaced": {
       "aliases": [],
       "args": {},
-      "description": "List available LLMs and their per-token costs",
+      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -844,17 +845,37 @@
           "multiple": false,
           "type": "option"
         },
-        "provider": {
-          "description": "Filter by provider (e.g. openai, anthropic)",
-          "name": "provider",
+        "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,
+          "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:llm-costs",
+      "id": "catalog:manyfaced",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -864,14 +885,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "llm-costs.js"
+        "catalog",
+        "manyfaced.js"
       ]
     },
-    "billing:quota": {
+    "catalog:restore": {
       "aliases": [],
-      "args": {},
-      "description": "Show compile token quota and per-face stats",
+      "args": {
+        "file": {
+          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
+          "name": "file"
+        }
+      },
+      "description": "Restore faces, teams, and source material from a backup snapshot",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -903,11 +929,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "compile": {
+          "description": "Run compile:all after restoring",
+          "name": "compile",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:quota",
+      "id": "catalog:restore",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -917,14 +949,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "billing",
-        "quota.js"
+        "catalog",
+        "restore.js"
       ]
     },
-    "billing:subscription": {
+    "billing:balance": {
       "aliases": [],
       "args": {},
-      "description": "Show current plan, face count, and renewal date",
+      "description": "Show credit balance and payment method status",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -960,7 +992,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:subscription",
+      "id": "billing:balance",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -971,13 +1003,13 @@
         "dist",
         "commands",
         "billing",
-        "subscription.js"
+        "balance.js"
       ]
     },
-    "billing:topup": {
+    "billing:card-setup": {
       "aliases": [],
       "args": {},
-      "description": "Top up credit balance using saved payment method",
+      "description": "Get a Stripe card setup URL to save a payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1009,26 +1041,11 @@
           "hasDynamicHelp": false,
           "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",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "billing:topup",
+      "id": "billing:card-setup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1039,13 +1056,13 @@
         "dist",
         "commands",
         "billing",
-        "topup.js"
+        "card-setup.js"
       ]
     },
-    "billing:usage": {
+    "billing:checkout": {
       "aliases": [],
       "args": {},
-      "description": "Aggregated usage analytics",
+      "description": "Get a Stripe checkout URL to upgrade your subscription plan",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1078,37 +1095,21 @@
           "multiple": false,
           "type": "option"
         },
-        "group-by": {
-          "description": "Group results",
-          "name": "group-by",
+        "plan": {
+          "description": "Plan to subscribe to",
+          "name": "plan",
+          "default": "connect",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "api_key",
-            "model",
-            "llm",
-            "date"
+            "connect"
           ],
           "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": "billing:usage",
+      "id": "billing:checkout",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1119,13 +1120,13 @@
         "dist",
         "commands",
         "billing",
-        "usage.js"
+        "checkout.js"
       ]
     },
-    "catalog:backup": {
+    "billing:llm-costs": {
       "aliases": [],
       "args": {},
-      "description": "Snapshot all faces, teams, and source material for migration",
+      "description": "List available LLMs and their per-token costs",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1157,11 +1158,18 @@
           "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": "catalog:backup",
+      "id": "billing:llm-costs",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1171,14 +1179,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "backup.js"
+        "billing",
+        "llm-costs.js"
       ]
     },
-    "catalog:doctor": {
+    "billing:quota": {
       "aliases": [],
       "args": {},
-      "description": "Diagnose and repair the local face and team catalog",
+      "description": "Show compilation stats per face (deprecated — use compile:stats)",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1210,23 +1218,11 @@
           "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": "catalog:doctor",
+      "id": "billing:quota",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1236,14 +1232,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "doctor.js"
+        "billing",
+        "quota.js"
       ]
     },
-    "catalog:list": {
+    "billing:subscription": {
       "aliases": [],
       "args": {},
-      "description": "List all faces in the local catalog",
+      "description": "Show current plan, face count, and renewal date",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1279,7 +1275,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "catalog:list",
+      "id": "billing:subscription",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1289,14 +1285,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "list.js"
+        "billing",
+        "subscription.js"
       ]
     },
-    "catalog:manyfaced": {
+    "billing:topup": {
       "aliases": [],
       "args": {},
-      "description": "Browse and install community manyfaced skills from github.com/facessh/manyfaced",
+      "description": "Top up credit balance using saved payment method",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1329,37 +1325,25 @@
           "multiple": false,
           "type": "option"
         },
-        "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",
+        "amount": {
+          "description": "Top-up amount in USD (min $1)",
+          "name": "amount",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "skills-dir": {
-          "description": "Directory to install skills into (required for --install)",
-          "name": "skills-dir",
+        "payment-ref": {
+          "description": "Payment reference (admin/test path)",
+          "name": "payment-ref",
           "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": "catalog:manyfaced",
+      "id": "billing:topup",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1369,19 +1353,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "manyfaced.js"
+        "billing",
+        "topup.js"
       ]
     },
-    "catalog:restore": {
+    "billing:usage": {
       "aliases": [],
-      "args": {
-        "file": {
-          "description": "Backup file path (default: most recent in ~/.faces/backups/)",
-          "name": "file"
-        }
-      },
-      "description": "Restore faces, teams, and source material from a backup snapshot",
+      "args": {},
+      "description": "Aggregated usage analytics",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1414,16 +1393,37 @@
           "multiple": false,
           "type": "option"
         },
-        "compile": {
-          "description": "Run compile:all after restoring",
-          "name": "compile",
-          "allowNo": false,
-          "type": "boolean"
+        "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:restore",
+      "id": "billing:usage",
       "pluginAlias": "faces-cli",
       "pluginName": "faces-cli",
       "pluginType": "core",
@@ -1433,8 +1433,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "catalog",
-        "restore.js"
+        "billing",
+        "usage.js"
       ]
     },
     "chat:chat": {
@@ -1905,6 +1905,59 @@
         "import.js"
       ]
     },
+    "compile:stats": {
+      "aliases": [],
+      "args": {},
+      "description": "Show compilation stats per face",
+      "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:stats",
+      "pluginAlias": "faces-cli",
+      "pluginName": "faces-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "compile",
+        "stats.js"
+      ]
+    },
     "compile:upload": {
       "aliases": [],
       "args": {
@@ -5780,5 +5833,5 @@
       ]
     }
   },
-  "version": "1.6.4"
+  "version": "1.6.6"
 }

package/package.json

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