faces-cli 1.8.5 → 1.8.7

package/dist/catalog.js

@@ -135,7 +135,7 @@ export class CatalogService {
                 // what kept it alive across writes; dropping it lets the next sync
                 // replace it with the real one.
                 if (existingDescription.length > MAX_FRONTMATTER_VALUE) {
-                    process.stderr.write(`warn: discarded a ${existingDescription.length}-character description on '${alias}' — ` +
+                    process.stderr.write(`warn: discarded a ${existingDescription.length}-character description on '${alias}': ` +
                         'too large to be real. It will be restored from the server on the next sync.\n');
                 }
                 else {

package/dist/commands/auth/connect.js

@@ -83,13 +83,13 @@ export default class AuthConnect extends BaseCommand {
         // 3. Show the code + URL and the one-time enable-setting guidance.
         emit('');
         emit('To connect ChatGPT:');
-        emit(`  1. Open this URL in any browser (phone, laptop — anywhere):`);
+        emit(`  1. Open this URL in any browser (phone, laptop, anywhere):`);
         emit(`       ${verificationUri}`);
         emit(`  2. Enter this code:  ${start.user_code}`);
         emit(`  3. Sign in to ChatGPT and click Continue.`);
         emit('');
         emit('If this is your first time, you may need to enable device-code authorization in ChatGPT first:');
-        emit(`  1. Open ${SETTINGS_URL}  (the settings panel can take a few seconds to appear — give it a moment)`);
+        emit(`  1. Open ${SETTINGS_URL}  (the settings panel can take a few seconds to appear, so give it a moment)`);
         emit('  2. Turn on "Enable device code authorization for Codex"');
         emit('  3. Then enter the code above');
         emit('');
@@ -193,7 +193,7 @@ export default class AuthConnect extends BaseCommand {
                 const steps = Array.isArray(d.settings_steps) && d.settings_steps.length > 0
                     ? d.settings_steps
                     : [
-                        `Open ${url}  (the settings panel can take a few seconds to appear — give it a moment)`,
+                        `Open ${url}  (the settings panel can take a few seconds to appear, so give it a moment)`,
                         'Turn on "Enable device code authorization for Codex"',
                         'Then run `faces auth:connect openai` again',
                     ];

package/dist/commands/auth/connections.js

@@ -26,7 +26,7 @@ export default class AuthConnections extends BaseCommand {
                         const tier = label ? ` (${label})` : '';
                         this.log(`openai  connected${who}${tier}  connected_at=${row.connected_at}`);
                         if (!plan || plan === 'free') {
-                            this.log('  ⚠️  This ChatGPT plan may not include API access — connecting requires a paid plan (Plus/Pro/Team, etc.).');
+                            this.log('  ⚠️  This ChatGPT plan may not include API access. Connecting requires a paid plan (Plus/Pro/Team, etc.).');
                         }
                     }
                     else {

package/dist/commands/billing/subscription/activate.js

@@ -46,7 +46,7 @@ export default class BillingSubscriptionActivate extends BaseCommand {
             }
             const result = data;
             if (!json) {
-                this.log(`Reactivated. Connect plan continues — next renewal: ${result.current_period_end ?? 'unknown'}.`);
+                this.log(`Reactivated. Connect plan continues. Next renewal: ${result.current_period_end ?? 'unknown'}.`);
             }
             return { status: 'reactivated', ...result };
         }
@@ -63,7 +63,7 @@ export default class BillingSubscriptionActivate extends BaseCommand {
         const result = data;
         const url = result.checkout_url;
         if (!json) {
-            this.log('Subscription Connect — $17/month');
+            this.log('Subscription Connect: $17/month');
             this.log('');
             this.log('Complete payment at this link:');
             this.log(`  ${url}`);

package/dist/commands/catalog/doctor.js

@@ -301,7 +301,7 @@ export default class CatalogDoctor extends BaseCommand {
                 }
                 catch (err) {
                     const msg = err instanceof FacesAPIError ? `Error (${err.statusCode}): ${err.message}` : String(err);
-                    this.log(`  ${alias}: failed — ${msg}`);
+                    this.log(`  ${alias}: failed: ${msg}`);
                 }
             }
             this.log(`Generated ${generated} description(s).`);

package/dist/commands/catalog/list.js

@@ -19,7 +19,7 @@ export default class CatalogList extends BaseCommand {
         if (this.jsonEnabled())
             return entries;
         if (entries.length === 0) {
-            this.log('(no faces in catalog — run faces catalog:doctor --fix)');
+            this.log('(no faces in catalog. Run faces catalog:doctor --fix)');
             return entries;
         }
         const nameWidth = Math.max(...entries.map((e) => String(e.alias ?? '').length));

package/dist/commands/chat/thread.js

@@ -73,7 +73,7 @@ function listThreads() {
     return out;
 }
 export default class ChatThread extends BaseCommand {
-    static description = 'Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json — resume any thread later with --id.';
+    static description = 'Multi-turn chat thread. Conversation history is stored under ~/.faces/threads/<id>.json. Resume any thread later with --id.';
     static examples = [
         '<%= config.bin %> <%= command.id %> socrates -m "What is justice?"',
         '<%= config.bin %> <%= command.id %> --id t_abc123 -m "Say more about that"',
@@ -99,7 +99,7 @@ export default class ChatThread extends BaseCommand {
     };
     static args = {
         face_username: Args.string({
-            description: 'Face alias (alias@model, or owner:alias@model for a published face) — required when starting a new thread',
+            description: 'Face alias (alias@model, or owner:alias@model for a published face). Required when starting a new thread',
             required: false,
         }),
     };

package/dist/commands/compile/all.js

@@ -64,7 +64,7 @@ export default class CompileAll extends BaseCommand {
         }
         if (items.length === 0) {
             if (!json)
-                this.log('Nothing to compile — all documents and threads are up to date.');
+                this.log('Nothing to compile. All documents and threads are up to date.');
             return { compiled: 0, failed: 0, items: [] };
         }
         if (!json)

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

@@ -17,7 +17,7 @@ export default class CompileDoc extends BaseCommand {
         ...BaseCommand.baseFlags,
         label: Flags.string({ description: 'Document label/title (single document only; with several files each is labelled by its filename)' }),
         content: Flags.string({ description: 'Inline text content', exclusive: ['file'] }),
-        file: Flags.string({ description: 'Read content from file (repeatable — each file becomes its own document)', multiple: true }),
+        file: Flags.string({ description: 'Read content from file (repeatable; each file becomes its own document)', multiple: true }),
         medium: Flags.string({ description: MEDIUM_FLAG_DESCRIPTION }),
         perspective: Flags.string({
             description: 'Perspective',
@@ -177,8 +177,8 @@ export default class CompileDoc extends BaseCommand {
 }
 /** Extensions the compile-documents endpoint takes as inline text. */
 const BINARY_HINTS = {
-    '.pdf': 'PDF is supported, but not by this command — use: faces compile:upload <alias> --file <path> --kind document',
-    '.docx': 'Word documents are supported, but not by this command — use: faces compile:upload <alias> --file <path> --kind document',
+    '.pdf': 'PDF is supported, but not by this command. Use: faces compile:upload <alias> --file <path> --kind document',
+    '.docx': 'Word documents are supported, but not by this command. Use: faces compile:upload <alias> --file <path> --kind document',
     '.doc': "Legacy '.doc' is not supported. Open it in Word or Pages and save as .docx, then upload that with: faces compile:upload <alias> --file <path> --kind document",
     '.pages': 'Pages documents are not supported. Export it as text or PDF first.',
     '.rtf': 'RTF is not supported. Convert it to plain text first (e.g. `textutil -convert txt file.rtf`).',

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

@@ -60,13 +60,13 @@ export default class CompileDocPause extends BaseCommand {
             }
             case 'synced':
             case 'ready': {
-                return 'Compile finished before the pause took effect — nothing to resume.';
+                return 'Compile finished before the pause took effect. Nothing to resume.';
             }
             case 'failed': {
                 return 'Compile failed before the pause took effect.';
             }
             case null: {
-                return 'Stopped — the compile is no longer running.';
+                return 'Stopped. The compile is no longer running.';
             }
             default: {
                 return `Still stopping after ${timeout}s. Poll with: faces compile:doc:get ${id} --json`;

package/dist/commands/compile/import.js

@@ -56,7 +56,7 @@ export default class CompileImport extends BaseCommand {
         catch (err) {
             if (err instanceof FacesAPIError) {
                 if (err.statusCode === 422 && flags.type === 'thread') {
-                    this.error(`${err.message} — try again with --type document`);
+                    this.error(`${err.message}. Try again with --type document`);
                 }
                 this.error(`Error (${err.statusCode}): ${err.message}`);
             }

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

@@ -1,9 +1,12 @@
 import { BaseCommand } from '../../../base.js';
 export default class CompileThreadEdit extends BaseCommand {
     static description: string;
+    static examples: string[];
     static flags: {
         label: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'face-speaker': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        medium: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'clear-medium': 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>;

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

@@ -1,14 +1,32 @@
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../../base.js';
 import { FacesAPIError } from '../../../client.js';
+import { MEDIUM_FLAG_DESCRIPTION } from '../../../utils.js';
 export default class CompileThreadEdit extends BaseCommand {
-    static description = 'Edit a thread (label and/or reassign face speaker)';
+    static description = 'Edit a thread: its label, what medium it is read as, and/or which speaker is the face.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> THREAD_ID --label "Interview"',
+        '<%= config.bin %> <%= command.id %> THREAD_ID --medium lecture',
+        '<%= config.bin %> <%= command.id %> THREAD_ID --clear-medium',
+    ];
     static flags = {
         ...BaseCommand.baseFlags,
         label: Flags.string({ description: 'New thread label' }),
         'face-speaker': Flags.string({
             description: 'Reassign face speaker: set this speaker to role=user, all others to role=assistant',
         }),
+        medium: Flags.string({
+            description: 'What this thread should be read as. ' +
+                MEDIUM_FLAG_DESCRIPTION +
+                ' This is a correction that sticks: it overrides what an imported corpus arrived as, without ' +
+                'changing the record of what that was.',
+            exclusive: ['clear-medium'],
+        }),
+        'clear-medium': Flags.boolean({
+            description: 'Remove a medium correction, so the thread is read as whatever it arrived as.',
+            default: false,
+            exclusive: ['medium'],
+        }),
     };
     static args = {
         thread_id: Args.string({ description: 'Thread ID', required: true }),
@@ -17,8 +35,8 @@ export default class CompileThreadEdit extends BaseCommand {
         const { args, flags } = await this.parse(CompileThreadEdit);
         const client = this.makeClient(flags);
         const json = this.jsonEnabled();
-        if (!flags.label && !flags['face-speaker']) {
-            this.error('Provide at least one of --label or --face-speaker');
+        if (!flags.label && !flags['face-speaker'] && !flags.medium && !flags['clear-medium']) {
+            this.error('Provide at least one of --label, --medium, --clear-medium or --face-speaker');
         }
         // If --face-speaker, fetch messages, remap roles, PATCH back
         if (flags['face-speaker']) {
@@ -64,18 +82,35 @@ export default class CompileThreadEdit extends BaseCommand {
                 process.stderr.write(`Remapped ${remapped} messages: "${speaker}" → user (${userCount}), all others → assistant (${assistantCount})\n`);
             }
         }
-        // If --label, update it
-        if (flags.label) {
+        // Label and medium go in one partial patch. Null is meaningful for medium
+        // and distinct from absent, which is how a correction is cleared.
+        if (flags.label || flags.medium || flags['clear-medium']) {
+            const body = {};
+            if (flags.label)
+                body.label = flags.label;
+            if (flags.medium)
+                body.medium = flags.medium;
+            if (flags['clear-medium'])
+                body.medium = null;
             try {
-                await client.patch(`/v1/compile/threads/${args.thread_id}`, { body: { label: flags.label } });
+                await client.patch(`/v1/compile/threads/${args.thread_id}`, { body });
             }
             catch (err) {
-                if (err instanceof FacesAPIError)
+                if (err instanceof FacesAPIError) {
+                    // The derived value is read-only and the server names the field to
+                    // send instead; pass that through rather than restating it.
                     this.error(`Error (${err.statusCode}): ${err.message}`);
+                }
                 throw err;
             }
-            if (!json)
-                process.stderr.write(`Label updated to "${flags.label}"\n`);
+            if (!json) {
+                if (flags.label)
+                    process.stderr.write(`Label updated to "${flags.label}"\n`);
+                if (flags.medium)
+                    process.stderr.write(`Now read as: ${flags.medium}\n`);
+                if (flags['clear-medium'])
+                    process.stderr.write('Medium correction removed.\n');
+            }
         }
         // Fetch final state and return
         let data;

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

@@ -61,13 +61,13 @@ export default class CompileThreadPause extends BaseCommand {
             }
             case 'synced':
             case 'ready': {
-                return 'Compile finished before the pause took effect — nothing to resume.';
+                return 'Compile finished before the pause took effect. Nothing to resume.';
             }
             case 'failed': {
                 return 'Compile failed before the pause took effect.';
             }
             case null: {
-                return 'Stopped — the compile is no longer running.';
+                return 'Stopped. The compile is no longer running.';
             }
             default: {
                 return `Still stopping after ${timeout}s. Poll with: faces compile:thread:get ${id} --json`;

package/dist/commands/face/diff.js

@@ -30,7 +30,7 @@ export default class FaceDiff extends BaseCommand {
         if (!this.jsonEnabled()) {
             const res = data;
             const faces = res.faces;
-            const fmt = (v) => (v === null || v === undefined ? '—' : v.toFixed(2));
+            const fmt = (v) => (v === null || v === undefined ? '-' : v.toFixed(2));
             for (let i = 0; i < faces.length; i++) {
                 for (let j = i + 1; j < faces.length; j++) {
                     const a = faces[i];

package/dist/commands/face/get.js

@@ -50,6 +50,14 @@ export default class FaceGet extends BaseCommand {
                 this.log(`address:   ${resolved.handle}@<model>  (chat only; it cannot join a team or be edited)`);
             }
             this.log(`created:   ${new Date(f.created * 1000).toISOString().slice(0, 10)}`);
+            // Only report a print that can actually serve; null means none installed.
+            // The field is a list so it can grow; today `style` is its only member,
+            // so echoing it back as "style: style" would say nothing.
+            if (f.deepself?.length) {
+                const others = f.deepself.filter((k) => k !== 'style');
+                const extra = others.length > 0 ? `, ${others.join(', ')}` : '';
+                this.log(`style:     installed${extra}  (writes in its own voice)`);
+            }
             if (f.read_only)
                 this.log('read only');
             if (f.formula) {

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

@@ -6,6 +6,7 @@ export default class FaceList extends BaseCommand {
         team: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         include: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         public: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'has-style': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         shared: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         system: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'from-users': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/face/list.js

@@ -12,6 +12,10 @@ export default class FaceList extends BaseCommand {
         team: Flags.string({ description: 'Filter by team ID (repeatable, OR logic)', multiple: true }),
         include: Flags.string({ description: 'Include extra fields: tags, teams (comma-separated)' }),
         public: Flags.boolean({ description: 'Include published faces from other accounts (open to everybody)' }),
+        'has-style': Flags.boolean({
+            description: 'Show only faces with a captured style (the ones that write in their own voice)',
+            default: false,
+        }),
         shared: Flags.boolean({ description: 'Include faces other accounts have shared with YOU in particular' }),
         system: Flags.boolean({ description: `Show only the curated system faces (published faces owned by '${SYSTEM_OWNER}')` }),
         'from-users': Flags.string({ description: 'Only published faces from these owners (repeatable/comma-separated)', multiple: true }),
@@ -70,6 +74,8 @@ export default class FaceList extends BaseCommand {
         // set — the caller's own faces always come back. Filter client-side so
         // --system / --from-users / --not-from-users actually mean "from these owners".
         let faces = raw;
+        if (flags['has-style'])
+            faces = faces.filter(f => Boolean(f.deepself?.length));
         if (fromUsers.length > 0) {
             const allow = new Set(fromUsers);
             faces = faces.filter(f => f.owned_by != null && allow.has(f.owned_by));
@@ -107,6 +113,10 @@ export default class FaceList extends BaseCommand {
                         const profile = f.profile_token_count ?? 0;
                         suffix = `  [profile: ${profile} tok, components: ${total}]`;
                     }
+                    // A face with a captured style answers as the person rather than as a
+                    // generic assistant, so it is worth seeing at a glance which do.
+                    if (f.deepself?.length)
+                        suffix += `  [${f.deepself.join(', ')}]`;
                     if (f.via?.length) {
                         const how = f.via.includes('shared') && f.via.includes('workspace')
                             ? 'shared with you, and via a workspace'

package/dist/commands/face/lock.js

@@ -2,7 +2,7 @@ import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 export default class FaceLock extends BaseCommand {
-    static description = 'Lock a face (read-only). A locked face still reads and chats normally, but it — and everything it owns (documents, threads, voiceprint) — cannot be changed until unlocked.';
+    static description = 'Lock a face (read-only). A locked face still reads and chats normally, but it, and everything it owns (documents, threads, voiceprint), cannot be changed until unlocked.';
     static examples = ['<%= config.bin %> <%= command.id %> socrates'];
     static flags = {
         ...BaseCommand.baseFlags,
@@ -24,7 +24,7 @@ export default class FaceLock extends BaseCommand {
         }
         if (!this.jsonEnabled()) {
             const res = data;
-            this.log(`Locked '${res.alias ?? args.face_id}' — read only.`);
+            this.log(`Locked '${res.alias ?? args.face_id}' is now read only.`);
             const affected = res.affected ?? [];
             if (affected.length > 0)
                 this.log(`Affected: ${affected.join(', ')}`);

package/dist/commands/face/neighbors.js

@@ -6,7 +6,7 @@ export default class FaceNeighbors extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         k: Flags.integer({
-            description: 'Number of results (1–20)',
+            description: 'Number of results (1-20)',
             default: 5,
             min: 1,
             max: 20,

package/dist/commands/face/share.js

@@ -15,7 +15,7 @@ export default class FaceShare extends BaseCommand {
         ...BaseCommand.baseFlags,
         list: Flags.boolean({ description: 'Show who the face is shared with, and change nothing', default: false }),
         add: Flags.string({
-            description: 'Add an account, keeping everyone already on the list — username or email (repeatable)',
+            description: 'Add an account, keeping everyone already on the list. Username or email (repeatable)',
             multiple: true,
             exclusive: ['with', 'none'],
         }),

package/dist/commands/face/sources.js

@@ -87,7 +87,9 @@ export default class FaceSources extends BaseCommand {
             label: s.label?.trim() || '(untitled)',
             tokens: s.token_count ?? 0,
             status: this.statusOf(s),
-            medium: s.medium?.trim() || '-',
+            // A thread carries a correction and a derived value; the correction wins,
+            // which is the order a style build resolves in.
+            medium: s.medium?.trim() || s.corpus_medium?.trim() || '-',
             updated: (s.updated_at ?? s.created_at ?? '').slice(0, 10) || '-',
             synced: Boolean(s.synced),
         };
@@ -103,7 +105,8 @@ export default class FaceSources extends BaseCommand {
             status: this.statusOf(s),
             synced: Boolean(s.synced),
             prepare_status: s.prepare_status ?? null,
-            medium: s.medium ?? null,
+            medium: s.medium ?? s.corpus_medium ?? null,
+            corpus_medium: s.corpus_medium ?? null,
             created_at: s.created_at ?? null,
             updated_at: s.updated_at ?? null,
             read_only: Boolean(s.read_only),

package/dist/commands/face/unlock.js

@@ -24,7 +24,7 @@ export default class FaceUnlock extends BaseCommand {
         }
         if (!this.jsonEnabled()) {
             const res = data;
-            this.log(`Unlocked '${res.alias ?? args.face_id}' — writable.`);
+            this.log(`Unlocked '${res.alias ?? args.face_id}' is now writable.`);
             const affected = res.affected ?? [];
             if (affected.length > 0)
                 this.log(`Affected: ${affected.join(', ')}`);

package/dist/commands/face/unpublish.js

@@ -2,7 +2,7 @@ import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 export default class FaceUnpublish extends BaseCommand {
-    static description = 'Stop publishing a face. Anyone it is individually shared with keeps their access — publishing is an ' +
+    static description = 'Stop publishing a face. Anyone it is individually shared with keeps their access. Publishing is an ' +
         'override on top of sharing, not a replacement for it.';
     static flags = { ...BaseCommand.baseFlags };
     static args = {

package/dist/commands/face/unshare.js

@@ -2,7 +2,7 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 export default class FaceUnshare extends BaseCommand {
-    static description = 'Revoke access to a shared face. Takes effect immediately — there is no grace period.';
+    static description = 'Revoke access to a shared face. Takes effect immediately. There is no grace period.';
     static examples = [
         '<%= config.bin %> <%= command.id %> alice --from dana --yes',
         '<%= config.bin %> <%= command.id %> alice --all --yes',

package/dist/commands/keys/create.js

@@ -55,15 +55,15 @@ export default class KeysCreate extends BaseCommand {
         }
         this.printHuman(data);
         this.log('');
-        this.log('⚠  The full key is shown only once — `faces keys:list` returns it truncated by design.');
+        this.log('⚠  The full key is shown only once. `faces keys:list` returns it truncated by design.');
         if (saved) {
-            this.log('✓  Saved to ~/.faces/config.json as api_key — faces commands will use it automatically.');
+            this.log('✓  Saved to ~/.faces/config.json as api_key. Faces commands will use it automatically.');
         }
         else if (!flags.save) {
             this.log('   Not saved (--no-save). Copy the key above now.');
         }
         else {
-            this.warn('Could not find the key in the response — nothing was saved. Copy it manually.');
+            this.warn('Could not find the key in the response. Nothing was saved. Copy it manually.');
         }
         return data;
     }

package/dist/commands/style/delete.js

@@ -4,15 +4,20 @@ import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 import { STYLE_FACES_PATH } from '../../style.js';
 /**
- * The API takes a scope: `map` clears the captured style, `all` clears it and
- * destroys the uploaded material with it. This CLI only ever sends `map`.
+ * The API takes a scope. This CLI only ever sends `map`.
  *
- * Nothing that removes a style should be able to take source text with it. A
- * user reaching for "delete the style" is not asking to lose the writing it was
- * learned from, and the two are one keystroke apart on the same command. Source
- * text is deleted through the commands that own it — compile:doc:delete and
- * compile:thread:delete — where that is the whole point of the call rather than
- * a side effect of a flag value.
+ * `map` removes the installed style. `all` removes it and everything derived
+ * from it — versions, jobs, checkpoints, style exemplars. **Neither touches the
+ * uploaded material.** The API reference said `all` destroyed it; that
+ * documentation was wrong and has been corrected, and the behaviour is not
+ * going to change (backend memo, 2026-08-28 pm).
+ *
+ * So the reason for sending only `map` is no longer that `all` is dangerous to
+ * source text. It is that one command should do one thing: this one forgets a
+ * style, and a deeper purge of derived artefacts is a different request nobody
+ * has asked for. Source text is deleted through the commands that own it,
+ * compile:doc:delete and compile:thread:delete, and a face's uploaded corpus
+ * through the corpus route — never as a side effect of a flag value here.
  */
 const SCOPE = 'map';
 export default class StyleDelete extends BaseCommand {

package/dist/commands/style/make.js

@@ -2,7 +2,7 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base.js';
 import { FacesAPIError } from '../../client.js';
 import { codexEligible } from '../../routing.js';
-import { BUILDS_PATH, DEFAULT_STYLE_MODEL, formatBuildReport, jobFailureMessage, listSelectable, parseSourceArg, pollStyleJob, publicJob, } from '../../style.js';
+import { BUILDS_PATH, DEFAULT_STYLE_MODEL, ROOM_DEFAULT_MEDIUM, formatBuildReport, jobFailureMessage, listSelectable, parseSourceArg, pollStyleJob, publicJob, } from '../../style.js';
 export default class StyleMake extends BaseCommand {
     static description = 'Capture how a face writes, from its own material, and install it. This is style, not knowledge: ' +
         'compile teaches a face what it knows, style teaches it how it sounds. Name the sources to learn ' +
@@ -173,14 +173,23 @@ export default class StyleMake extends BaseCommand {
         else {
             chosen = [];
             const missing = [];
+            // Naming a source twice is accepted by the server and prints it twice,
+            // which weights it double in the analysis for no stated reason. A later
+            // mention wins so `--source X --source X:essay` declares a medium rather
+            // than being a contradiction.
+            const seen = new Map();
             for (const raw of flags.source ?? []) {
                 const { id, medium } = parseSourceArg(raw);
-                const s = byId.get(id);
-                if (s)
-                    chosen.push({ s, declared: medium });
-                else
+                if (!byId.has(id)) {
                     missing.push(id);
+                    continue;
+                }
+                if (seen.has(id) && medium === undefined)
+                    continue;
+                seen.set(id, medium ?? seen.get(id));
             }
+            for (const [id, medium] of seen)
+                chosen.push({ s: byId.get(id), declared: medium });
             if (missing.length > 0) {
                 this.error(`Not a source on '${alias}': ${missing.join(', ')}\n` +
                     `List what is there with: faces face:sources ${alias}`);
@@ -189,17 +198,30 @@ export default class StyleMake extends BaseCommand {
         const undeclared = [];
         const sources = [];
         for (const { s, declared } of chosen) {
-            // Precedence: an explicit --source id:medium, then whatever the source
-            // itself declares, then --medium as a fallback for sources that say
-            // nothing. --medium must not override a source's own declaration: doing
-            // that silently resubmits a document that says "essay" as something else,
-            // and the stamp it leaves behind then misreports how it was read.
-            const medium = declared ?? s.medium ?? flags.medium;
-            if (!medium) {
+            // A medium the source already declares is NOT sent. The server resolves it
+            // from the source itself, which cannot go stale the way our reading of its
+            // fields can — reading a renamed field once filed three corpus rooms as
+            // conversations. What we send is only ever what the caller chose.
+            //
+            // --medium fills gaps and must not override a source that declares one:
+            // resubmitting a document that says "essay" as something else leaves a
+            // stamp misreporting how it was read.
+            //
+            // A live thread declares nothing and is a conversation by construction, so
+            // that default comes last, after anything the caller asked for.
+            const chosenMedium = declared ?? (s.medium ? undefined : flags.medium);
+            if (chosenMedium) {
+                sources.push({ id: s.id, medium: chosenMedium, source_type: s.sourceType });
+            }
+            else if (s.medium) {
+                sources.push({ id: s.id, source_type: s.sourceType });
+            }
+            else if (s.isLiveThread) {
+                sources.push({ id: s.id, medium: ROOM_DEFAULT_MEDIUM, source_type: s.sourceType });
+            }
+            else {
                 undeclared.push(s);
-                continue;
             }
-            sources.push({ id: s.id, medium, source_type: s.sourceType });
         }
         if (undeclared.length > 0) {
             const list = undeclared
@@ -210,10 +232,10 @@ export default class StyleMake extends BaseCommand {
                 '  --medium email                 applies to every source that does not say',
                 `  --source ${first.id}:email   applies to just this one`,
             ];
-            // Only a document can record a medium on itself; a thread has no such field.
-            if (first.sourceType === 'document') {
-                ways.push(`  faces compile:doc:edit ${first.id} --medium email   records it permanently`);
-            }
+            // Both kinds can now record it permanently, through different commands.
+            ways.push(first.sourceType === 'document'
+                ? `  faces compile:doc:edit ${first.id} --medium email   records it permanently`
+                : `  faces compile:thread:edit ${first.id} --medium email   records it permanently`);
             this.error(`These sources do not say what sort of writing they are, and a style build will not guess:\n${list}\n\n` +
                 `Declare it, using the real medium rather than the example:\n${ways.join('\n')}\n\n` +
                 'A wrong declaration is worse than a missing one: a mislabelled source teaches the wrong voice ' +